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The software product identified as Multics Forum is the property of the Massachusetts 
Institute of Technology and distributed by Honeywell Information Systems under license from 
the Massachusetts Institute of Technology. 


This book is a detailed description of the Multics Forum Interactive Meeting System. It 
is intended for all users; both those who have relatively little experience on the Miultics 
operating system (or any other computer system) and experienced programmers will find this a 
complete description. You are, however, expected to be familiar with the Multics concepts 
described in the 2-volume set, New Users’ /ntroduction to Multics -- Part I (Order No. 
CH24), and -- Part II (Order No. CH25), referred to in this manual as New Users’ 
Introduction. 


The sections of this manual fully describe how to attend Forum’s online meetings. The 
first five sections tell you everything you need to know to attend meetings. This part of the 
manual may be all you need if you are a beginning Multics user. Section 6 describes some 
advanced concepts, including how to tailor your Forum environment to your specia] needs. 
Section 7 contains detailed descriptions of all the Forum requests. Section 8 is an alphabetical 
reference section of users’ commands. Section 9 describes the duties of the chairman of the 
meeting. Section 10 is an alphabetical reference to the chairman’s commands. Appendix A 
contains information needed by system administrators. Appendix B contains the subroutine 
descriptions. Appendix C is a glossary of Forum terms. 


Manual Conventions 
A few conventions and special symbols used in this manual should be introduced before 


you begin to explore the Multics Forum Subsystem. 


Throughout the manual, "Forum" designates the Multics Forum Subsystem and the 
all-lowercase "forum" refers to the Multics command invoked to use this system. 


Technical or other unfamiliar terms are italicized when used the first time, and are 
defined in the glossary in Appendix C. 


The information and specifications in this document are subject to change without notice. This 
document contains information about Honeywell products or services that may not be available 
outside the United States. Consult your Honeywell Marketing Representative. 


© Honeywell Information Systems Inc., 1985 File No.: 1153, 1U53 CY74-02 


Quotation marks are used to indicate the exact spelling of a request or command name, 
or the way a word should appear on a line typed by a user. Requests or commands that also 
have a short or abbreviated name appear in parentheses following the first occurrence of the 
name in text~-for example, when introducing the “talk” (t) request. You do not type these 
quotation marks or parentheses. 


A convention used within ‘examples is the use of an exclamation point (!) to indicate 
lines you type. The exclamation point does not appear on your terminal—-you do not type it, 
and Muitics does not type it to prompt you. Exclamation points appear only in examples, and 
only to show which lines you type. Remember too, that every line you type must end with a 
carriage return (RETURN). 


Text within angle brackets (<...>) is used within examples for explanatory purposes 
ONLY. It is not actually typed by Multics, and it should not be typed by you. 


Throughout this manual, references are made to the Mu/tics Programmer's Reference 
Manual (Order No. AG91), Mu/tics Commands and Active Functions (Order No. AG92), 
and Mu/tics Subroutines and //0 Modules (Order No. AG93) manuals. For convenience, 
these are referred to in text as the Programmer’s Reference manual, the Commands manual, 
and the Subroutines manual, respectively. 


Significant Changes in CY74-02 


A forum meeting created with pre-MR11 software consists of two storage system 
segments which contain records of the participants in the meeting and what has Deen said. 
These meetings contain the suffixes “.control": or "“.proceedings". A current version forum 
meeting (MR11 or later) is created as a single segment with the suffix ".forum". The current 
version forum software supports both pre-MR11 forum meetings and current version forum 
meetings. 
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The meetings created with current version forum software are treated as entries within 


the Multics storage system. Since current version forum meetings are treated as such, you can 
use the standard file system commands such as copy, delete, list_acl, and set acl. This support 


also alleviates limitations on the number of meeting attendees and transactions. Current 
version meetings have no easily relizable limit on the amount of information which they can 
contain. 


The current version forum also incorporates a new search strategy for locating forum 
meetings by looking in the forum list to find the meetings. 


Forum now allows you to use transaction specifiers with forum requests. See Section 3 
for details. 


Forum now marks each transaction with the keyword “seen” or “unseen”. See Section 3 
for details. 


The following new requests have been added to forum: 


add_meeting (am) mai | 
announcement_info (ai) next_meeting (nm) 
announce_meeting (anm) remove_meeting (rm) 


check_meetings (ckm) 


See Section 7 for details. 


The safety switch and the seen TRANS_SPECS switch have been added to the 
switch_off and switch_on commands. See Section 7 for details. 


New contro] arguments have been added to the following requests: 


list_users (lsu) talk (t) 
qedx (qx) ted 
reply (rp) write {w) 
reset (rs) 


See Section 7 for details. 


Two new user commands have been added to assist you in managing the list of meetings 
that you attend. The forum_add_meeting (fam) command adds a meeting to the list of 
attended meetings. The forum_remove_meeting (frm) command removes a meeting from the 
list of attended meetings. See Section 8 for details. 


New control arguments have been added to the forum_list_users (flsu) user command. 
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You can now use the standard access control list (ACL) commands (list_acl, set_acl, and 
delete_acl) with forum meetings. See Section 9 for details. 


The new convert_forum command converts a forum meeting created with pre-MR11 
software to a current version forum meeting. See Section 10 for details. 


The new site meeting directory is a public meeting where you can place announcements 
about meetings of generai interest. See Appendix A for details. 


The entries in the forum_chairman_ gate have been moved to the forum_ gate. 


The following entries have been added to the forum_ subroutine: 


forum_Schange_chairman 
forum_Schname_forum 
forum_S$change_chairman_idx 
forum _Schname_forum_idx 
forum _Screate_forum 
forum_Sset_v1]_forum_acl 
forum_Sconvert 

forum _Sdelete_forum_ac] 
forum_Sexpunge 
forum_Sget_switch 

forum _Sget_uid_file 
forum Slist_forum_ac] 
forum_Sreplace_forum_acl 
forum_S$set_forum_ac] 
forum_Sset_seen_switch 


The following entry has been added to the forum_admin_ subroutine. 


forum_admin_Sconvert 


See Appendix B for details. 
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SECTION 1 


INTRODUCTION TO FORUM 


MEETINGS--WITH A DIFFERENCE 


The Multics Forum subsystem lets you engage in ongoing discussions about any topic in 
an orderly and controlled fashion. 


Forum is often described as a teleconferencing system and is sometimes described as a 
bulletin board system. Actually, it is a bit of both. Using Forum, you can create (convene) 
meetings; you can specify exactly who may participate in the meetings; and you can pose 
questions, make assertions, offer opinions, and express points of view to the other 
partici pants. 


The system parallels the structure and function of "real" meetings. Forum provides 
requests that allow you to enter a meeting, see who else is participating, find out what has 
been said since the last time you attended the meeting, and comment on any topic under 
discussion. 


Forum, however, overcomes the restrictions of real meetings in several important ways. 
Forum’s meetings can last for weeks or months and, no matter when you decide to "drop 
in," you can read every comment made since the meeting’s inception. Even if you have 
nothing to say in the meeting, it’s a great way to keep abreast of all developments. 


Another difference is that by using Forum, groups of people can effectively 
communicate with each other even when separated by great distance in both space and time. 
For instance, many meetings now in use involve people located in all parts of the United 
States, Canada, and much of Western Europe. 


BENEFITS AND TYPICAL USES OF FORUM 


User communities put Forum to many interesting uses. Frequently, special interest groups 
establish meetings to allow all the members of a project team to effectively communicate and 
coordinate their activities (a sort of project management tool). Some meetings are useful 
places to solicit information from a wide body of users on a given subject ("Anyone know of 
a good article on PASCAL implementations?"). Often, a real bulletin board meeting is put up, 
so that people can advertise or solicit lodgings, places to get their cars fixed, and so on. 
Some meetings are design review meetings, in which someone proposes a detailed design and 
invites comments from co-workers and others. In general, meetings can be used for any 
purpose whatsoever. 
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The main benefit of Forum can be summarized in one word: information. Forum 
enables the effective distribution of information from the people who have the knowledge to 
the people who need the information and overcomes the barriers imposed by space, time, and 
number of participants. It is not meant to replace electronic mail, for there is no substitute 
for a secure and flexible system for one-to-one or one-to-few communication. It is rather 
designed to establish a wider community of users, sharing their knowledge and keeping them 
well-informed on issues of interest. 


THE MEETING 


Meetings can be public meetings, which are open to everyone, or private meetings, 
which are open only to designated participants. The creation of a public or private meeting is 
an option available to the chairman when the meeting is created. Section 2 describes how to 
determine whether you are eligible to attend a meeting. Section 9 describes how a chairman 
can set up public and private meetings. 


Transactions 


Meetings consist of a series of transactions. Entering a transaction in a Forum meeting 
is equivalent to speaking in a live meeting. If you are the chairman of a meeting, you first 
convene (create) the meeting and decide who will be eligible to attend. Then you enter the 
first transaction, which states the purpose of the meeting. Eligible participants can add entries 
(transactions)--this collection of transactions makes. up the meeting. Here are some sample 
transactions: 


[0001] (5 lines) Brooks.ProjA 05/18/83 0320.9 est Mon Everybody's meeting 
Subject: Reason for this meeting 

This meeting is a general meeting, open to all, and open to discussion of 
any issues related to the Multics system. !ssues related to the 

forum subsystem itself should be discussed in the forum_problems 

(forprob) meeting, and so-called public notices should be placed in the 
Bulletin_board (bb) meeting. 

---[0001]--- 


This is a sample initial transaction for a meeting called "Everybody’s_Meeting." Forum 
numbered the transaction and supplied the other information shown in the first line. [0001] 
is its transaction number. (The chairman of a meeting always enters the first transaction in a 
meeting.) The rest of the first line describes how long the text of the transaction is (5 lines), 
who entered it (Brooks.ProjA), and the date and time it was entered (5/18/83 0320.9 est 
Mon). The user Brooks (on the ProjA project) typed in the subject and the text. 


[0002] (3 lines) Davis.YAK 05/20/83 0002.3 est Wed Everybody's Meeting 
Subject: Fortran for a Beginner 

Does anyone have a really good, basic, simple book about Fortran and the 
basic commands? | just want to put a little variety into my repertoire 
of languages. 

---[0002]--- 
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This is a sample second transaction, entered into the meeting by a user named Davis on the 
YAK project. A transaction that starts discussion on a new topic is entered via Forum’s 
"talk" (t) request (described in section 5). The talk request always prompts for the subject of 
your transaction. 


As a participant you understand that the initial transaction and statement of purpose 
(see [0001] above) throws the session open to discussion. From that point on, any eligible 
participant can bring up any related subject or idea. The initial transaction is numbered 
Transaction 1, and transactions are numbered sequentially by Forum as you enter them. The 
meeting remains open to discussion indefinitely since meetings are open-ended and have no 
time limit on their existence. When the chairman feels that the meeting has fulfilled its 
purpose or outlived its usefulness, he or she deletes it. 


Transaction Chains 


A reply to any transaction begins a transaction chain--a discussion concerning a 
previous transaction. Entering a transaction that refers to a previous transaction is equivalent 
to making a comment on a previous statement in a live meeting. Here is an example: | 


[0006] (1 line) Perri.YAK 05/23/81 1005.9 est Wed Everybody's Meeting | 
Subject: Re: Fortran for a Beginner 

Try the Fortran book by McKracken (or however you spell it!) 
---[0006j--- 


User Perri wanted to make a suggestion regarding transaction [0002] (shown above) so he 
used Forum’s "reply" request (described in Section 4). The reply request automatically 
generated the subject as shown here. This transaction chain now consists of transactions 
[0002] and [0006]. Transaction chains often grow quickly as other attendees interject 
Opinions on the same subject. 
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SECTION 2 


GETTING STARTED 


This section tells you how to enter the Forum subsystem and introduces the Forum 
tequest loop. You will find out where meetings are held on your system and how to attend 
them. 


ENTERING THE FORUM SUBSYSTEM 


The Request Leop 

Once you invoke Forum, everything you type is interpreted by the Forum = request 
processor, not the Multics command processor. You will use Forum requests to accomplish 
your tasks. To enter the Forum subsystem, simply issue the "forum" command: > 


! forum 


forum: 


This enters you into the request /oop. The prompt "forum:" appears on your screen which is 
where you are to type any of the various requests in Forum’s repertoire. Forum request lines 
must end with a carriage return, just like Multics commands. Forum processes a request by 
performing the desired action, and then prompts you for another request. This cycle repeats 
until you quit forum (by issuing the “quit" request described below). 


At this point, you are not attending a meeting, but there are a number of things you 
can do such as list meetings and get help. 
Listing Meetings 


The forum request “list_meetings" (or the short form, Ism) is used to print out a list of 
all the meetings that you are eligible to attend: 


forum: ! Ism 
Meetings = 3, Changed = 0 


Everybody's Meeting eve 


Bul letin_board bb 
Personal_computers pe 
forum: 
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This is a list showing the long and short names of meetings that you can participate in. 
Since you have not attended any meetings yet, none of them are reported as changed 
("Changed = 0"). (You can get the same information with the Muitics command 
forum_list_meetings (flsm) described in Section 8.) 


After you attend some meetings, the output also prints some flags for each meeting. 
The flags are the individual letters in the leftmost columns. They tell you what sort of rights 
you have relative to each meeting and what your state is for each meeting. The "a" flag 
means that you are currently attending that meeting. The "p" flag means that you are already 
a participant of the meeting (have previously attended the meeting). The "c" flag means that 
the meeting has changed (which means simply that other participants of that meeting have 
entered transactions since the last time you attended the meeting). The "o" flag means that 
you are eligible only to be an observer, ie., you can read the transactions but cannot enter 
any transactions. The "n" flag means that you have the notify switch turned on, that is, that 
you have asked to receive an automatic online notification every time a transaction is entered 
in the meeting. The "r" flag means that you have removed yourself from participation in the 
meeting. The "j" flag indicates meetings which have been adjourned by the chairman. For a 
complete description of how to turn these flags on and off, see the "switch_on" and 
“switch_off" request descriptions in Section 7. 


Getting Help 


Forum offers various ways to get help at your fingertips. For a list of availabie Forum 
requests, type a "2". To get a brief description of the requests, type “list_requests" (Ir). To 
get a detailed explanation of requests and other Forum topics, type “help TOPIC" where 
TOPIC is the name of a request or other topic. For a list of TOPICS for which help is 
available, type "list_help" (lh). These requests are explained in more detail in Section 5. 


LOCATING MEETINGS 


Before you attend a live meeting, you musi first find out where it is being heid. 
Meetings can be stored in the central Forum directory or meetings can be stored in a private 
directory created by any user. Directions for finding meetings are described below. 


The Central Forum Directory 


The central forum directory is the main location for meetings that have been set up for 
public exposure at each site. The forum_dir (fd) command/active function (fully described in 
Section 8) prints your site’s central forum directory: 


! fd 


The central forum directory is >site>forum_dir. 
r 08:31 0.171 0 


Thus, to attend a meeting called "fortran" in the central forum directory, you would type: 


! forum >site>forum_dir>fortran 
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Meetings in Private Directories 


Meetings can be created and stored anywhere in the Multics storage system. In order 
for you to locate any of these “private” meetings, one of the participants must supply you 
with the full pathname of the meeting. Thus, if user JohnB creates a meeting called 
“"new_projects" in the directory 

>udd>ProjA>JohnB>meetings, you can attend this meeting by entering the command: 


! forum >udd>ProjA >JohnB>meetings>new_projects 


Forum Search Paths 


A short-cut to typing the full pathname every time you want to attend a meeting is the 
use of the forum search paths. 


There are usually two search paths in your forum search /ist put there automatically 
every time you log in. One is the central forum directory, and the other is a directory 
under your home directory called "meetings" (whether it exists or not). 


Issue the print_search_paths (psp) command (fully described in the Commands manual) 
to print your forum search paths: 


! psp forum 
forum 
>udd>[user project]>[user name]>meetings 
>site>forum_dir 
r 08:32 0.201 3 


You can attend any meetings kepi in these directories by telling Forum only the meeting’s 
name (not the full pathname). Forum searches these directories automatically to find it. 


To allow Forum to find meetings that do not reside in the central forum directory, but 
that you will be attending frequently, add their pathnames to the forum search list. Suppose 
you want to attend meetings under JohnB’s home directory. Before entering Forum, type the 
Multics command line: 


! asp forum >udd>ProjA>JohnB>meetings 


to add the pathname of the directory to the forum search paths. Or, if you have already 
invoked the Forum subsystem, issue the request: 


! ..asp forum >udd>ProjA>JohnB>meetings 


to add the location of JohnB’s meetings to your already-established forum search paths. Now 
whenever you want to attend the User_issues meeting in that directory, simply type "forum 
User_issues" at Multics command level, or "goto User_issues" from Forum request level. The 
"goto" request is simply the request that tells Forum what meeting you want to attend. 
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If you use one of the above methods, you must type issue the add_search_paths 
command every time you log in to attend JohnB’s meetings. If you modify your search list 
in your start_up exec_com, it enables Forum to locate these meetings every time you login. 


Cn Len Afmras fil narwal wmtpemalrsnti mm. Daw i ree ete Iron Rm “LIME Lane wn rae am, 
See the New Users’ /ntroduction--Part // manual, Order No. CH25 for a description of 


the start_up.ec. 


Adding a Meeting 


If you don’t want to enter the full pathname of meetings, you can use the 
forum_add_meeting, (fam) command to add the meetings you want to attend to your forum 
search list. The forum_add_meeting command creates links to the meetings in the directory 
>udd>Project>Person>meetings and makes you a participant in the meeting. To add a meeting 
to your forum search list, go to your "meetings" directory. 


! create_dir [hd]>meetings 
and add the pathnames of forum meetings to be added to the search list: 


! fam >udd>ProjA>BruceM>meetings>User_issues 


Forum searches in a directory called "meetings" under your home directory by default. If the 
home_directory named meetings does not exist, the add_meeting command will create a link 
to this directory. 


To attend the User_issues meetings, type "forum User_issues" (or "goto User_issues” if 
you are already in the request loop) and Forum will locate the link for the User_issues 
meeting. 


The create_dir and the home_dir active functions are fully described in the Mu/tics 
Commands and Active Functions manual, Order No. AG92. The forum_add_meeting 
command is described later in this manual. 


ATTENDING A MEETING 
There are two ways to enter a meeting. One way is to give the meeting’s name as an 
argument to the forum command when you first invoke the subsystem. For example, to enter 
the Everybody’s_Meeting (short_name “eve"), type: 
! forum eve 
Everybody's Meeting: 9 new, 10 last. 


The meeting is public. 


forum: 
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If you are already inside Forum’s request loop, use the "goto" request: 


forum: ! goto eve 
Everybody's Meeting: 9 new, i0 iast. 
The meeting is public. 


forum: 


You are now attending the meeting and have become a participant in it. The "9 new, 10 
last" message tells you that there are 9 transactions that you have not yet seen and that the 
10th transaction is the last one entered in the meeting. The first transaction, the chairman’s 
initial message, is not included in the count. 


The message "The meeting is public" is an eligibility message, which is printed 
automatically when you first enter a public meeting (if the chairman of the meeting and site 
administrator have turned it on--see Section 9 for details). If the meeting is private, the 
eligibility message gives you other information instead such as, "There are 20 users and 2 
projects eligible to attend". 


Now that you are attending "Everybody’s_Meeting,” each request that you issue pertains 
to this meeting until you leave it and enter a different meeting with the "goto" request. 


Finding Out Who Is Chairman 


To find out who is chairing the meeting, type: 


forum: ! chairman 
Brooks.ProjA 
forum: 


The "chairman" (cm) request gives you the Person_id.Project_id of the chairman of 
Everybody’s_ Meeting. 
Listing Other Participants 


To find out who else is participating in the meeting, use the "list_users" (lsu) request: 


forum: ! list_users 
Users of the >udd>ProjA>forum>Everybody's Meeting meeting. 


Flags Person Last [0010] Last time attended 
JohnB.ProjA [0009] 03/22/83 1103.3 est Mon 
LeeB.ProjA *xEND* 04/07/83 0202.3 est Wed 

forum: 
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On the header line, "Last [0010]" means that the last transaction in the meeting is number 
ten, and the list shows the transaction number of the last one read for each user. "*END+#" 
means that the indicated user has read the proceedings through to the end (through the last 
transaction). 


The -eligible control argument to the “list_users” request tells who is e/igib/e to 
participate in the meeting, rather than who currently participates. This request line tells you 
who else is explicitly able or unable to attend. 


Check the eligible users in the "eve" meeting: 
forum: ! Isu -eligibie 


Eligible users of the >udd>ProjA>forum>Everybody's Meeting meeting. 
The meeting is public. 


The following users are not eligible to participate: 
DVader 


forum: 


The "eve" meeting in the above example is a pre-MR11, public meeting in which the 
chairman has not (with one exception) specified any users or projects as eligible or ineligible 
to participate. The following is an example of the output from the same request line issued 
in a private, current version forum meeting: 


forum: ! Isu -eligible 
| Eligible users of the >lib>forum>forum_dir>Bulletin_board meeting. 


rw Vade.*x.x 
| rwe IJah 
| rw *&,x,% 


| forum: 


| The access mode "r" allows you to read transactions, "w" allows you to enter tranactions and 
| "c" gives you chairman access. In the above forum meeting, all participants can read and 
| write transactions but only the participant [Jah is designated as the chairman. 
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MANAGING MEETINGS 


Two commands are available to assist you in managing the list of meetings that you 
attended. The forum_add_meeting (fam) command (described in Section 8) adds a meeting to 
the list of meetings attended. The add_meeting (am) request (described in Section 7) also adds 
a meeting to the list of meetings attended. You can invoke the add_meeting request on a 
meeting pathname or on a transaction number of a meeting announcement. 


The forum_remove_meeting (frm) command (described in Section 8) removes a meeting 
from the list of meetings attended. The remove meeting (rm) request (described in Section 7) 
also removes a meeting from the list of meetings attended. You can invoke the 
remove_meeting request on a meeting pathname. 


You can use the announce_meeting (anm) request (described in Section 7) to 
automatically place an announcement about a newly created meeting either into the site’s 
public meeting directory or a private meeting. For more information on the Site Meeting 
Directory, refer to Appendix A later in this manual. This announcement is in a format 
acceptable to the add_meeting request. Other users can use this announcement with the 
add_meeting request to add the current meeting to their search list. 


To specify where you want the announcement to be placed, use the —meeting (—mtg) 
control argument with the announce_meeting request. After you have used the announce 
meeting request to place an announcement in another meeting, you can use the announcement_info 
request to extract information from a meeting announcement. This request must refer to a 
transaction entered by announce_meeting, otherwise an error will occur. 


EXITING FORUM 


Maybe you’ve had enough for now and would like to get out of Forum. Simply use 
the forum “quit” (or q) request: 


forum: ! a 
r 09.19 1.007 4&4 


When you receive the ready message, you Know you are out of Forum and back at Multics 
command level. 
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SECTION 3 
READING TRANSACTIONS 


This section describes how to peruse the proceedings of a meeting. The first part of 
this section tells you how to list transactions, i.e, how to print a list that tells you a little 
bit about each transaction that was entered in the meeting. The second part of this section 
shows you how to print transactions, i.., how to read the contents of the transactions that 
you’re interested in. The third part of this section introduces the write request which is used 
to save transactions in a separate segment. The fourth part of this section tells you about 
transaction specifiers, i.e., about the ways that you can tell Forum to list, print or write only 
certain transactions (the ones that you specify). The last part of this section tells you how to 
make sure that you stay aware of new transactions in the meetings that are of importance to 
you. 


LISTING TRANSACTIONS 


You can find out summary information about the proceedings of a meeting with the 
"list" (Is) request. It gives you a brief description of each transaction including the 
transaction number, its length (how many lines it contains), the date and time it was entered, 
the author’s name, and the subject of the transaction. 


Let’s assume that you're still attending "Everybody’s Meeting", which you entered in 
Section 2. The “list™ request used at this point lists all transactions in this meeting. To 
obtain a summary report of these transactions, type: 


forum: ! list 

Trans# Lines Date Time Author Subject 

[0001] (5) 05/18/81 03:20 Brooks.ProjA Reason for this meeting 
[0002] (3) 05/20/81 03:46 Davis.YAK Fortran for a Begin<More> 


[0003] (3) 05/21/81 06:49 Smith.ProjB Other Meetings 


forums 


If you don’t want to see a list of ail the transactions in the meeting, you can specify 
only those that meet a certain criteria by using transaction specifiers. The simplest case is 
specifying a transaction by its transaction number. For example, typing “list 1” will print only 
a@ summary line about transaction [0001]. See the section on "Transaction Specifiers" below. 
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PRINTING TRANSACTIONS 


Transaction [0001] states the reason for this meeting. To print it on your terminal, use 
the "print" (pr, p) request with the transaction specifier "1": 


forum: ! print 1 

[0001] (5 lines) Brooks.ProjA 05/18/81 0320.9 est Mon eve 

Subject: Reason for this meeting 

This meeting is a general meeting, open to all, and open to discussion 
of any issues related to the Multics system. Issues related to the 
forum subsystem itself should be discussed in the forum_problems 
(forprob) meeting, and so-called public notices should be placed in 
the Bulletin_board (bb) meeting. 

---[0001}--- 


forum: 


You can find out through the list request (see above) which other transactions you want 
to print. Use their transaction number to do so (eg., "print 2"), or use a string of 
transaction numbers (e.g., "print 2 3 4"). To go through and print them one by one by use 
the "next" (n) keyword; instead of "print 2", type "print n". A keyword is another kind of 
transaction specifier (see "Transaction Specifiers" below). 


WRITING TRANSACTIONS 


If you want to save the transactions of a meeting in a separate segment for use later, 
use Forum’s "write" (w) request. This request writes a copy of each transaction matching your 
selection criteria (or the current transaction if you don’t specify any in particular) to a 
segment created in your working directory. You can give the segment any name you want by 
using the "-pathname PATH" contro/ argument. Forum will append the suffix ".trans" to 
PATH automatically if you don’t supply it. If you wish to create the segment in another 
place in the storage system (i.e., in a directory different from your current working 
directory), you can give a full pathname for PATH. See the New User’s Introduction——Part I 
for a description of pathnames. If you do not give the -pathname control argument, Forum 
will create <meeting_name>.trans in your working directory, where <meeting_name> is the 
name of the current meeting. 


To write the 10th transaction in the Everybody’s_Meeting to a segment named 
“save_this.trans” in your working directory, type the following: 


forum: ! write 10 -pathname save_this 
Writing 1 transaction to >udd>ProjA>Your_name>save_this.trans. 


forum: 


If you also want to save transactions 15 through 20 in the same file, type: 


forum: ! write 15:20 -pn save_this 
Appending 6 transactions to >udd>ProjA>Your_name>save_this.trans. 


forum: 
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As you can see, you can specify a range of transactions in the current meeting, in this case 
"15:20" for transactions 15 through 20 inclusive. The above request line appends the 
transactions to save_this.trans, separating the transactions by appending a formfeed character 
{new page) to each. Each transaction is printed on a separate page by default, but you can 
specify different delimiters (if any) with either the -separator or -no_separator control 
arguments (see the “write” request description in Section 7). If you save additional 
transactions in this segment, they too are appended to the end. 


The most common use of the write request is to print copies of a meeting’s transactions 
on a line printer. An option you can choose to format the output pages is the "-format" 
(-fmt) control argument. The display consists of a page header containing the current date 
and time, the name of the meeting, and the page number, and a footer containing the subject 
of the first transaction on the page. The header and footer are separated from the text by a 
line of underscores and a blank line. Transactions are only split across pages if they are 
longer than one page. If a transaction does not fit on the remainder of the current page, a 
new page is always created. The -separator control argument may not be used when 
formatting output. 


TRANSACTION SPECIFIERS 


You can reference individual transactions or groups of transactions in a meeting by 
using transaction specifiers. The list, print, write, delete, retrieve, reset, reply, and apply 
requests all use transaction specifiers. These transaction specifiers can be transaction numbers, 
keywords, the arithmetic operations + and -, person_ids, control arguments, and qedx-type 
Tegular expressions. 


In addition, you can use the keywords listed below as requests and active requests to 
return transaction numbers. Each transaction specifier causes forum to search the current 
meeting for all transactions that meet a certain criteria spelled out by the transaction 
specifiers. 


Transaction Numbers 


Forum assigns numbers to transactions as it enters them into the proceedings of a 
meeting. Wher you enter 4 meeting for the firsi time, Forum auiomaticaiiy takes you to the 
first transaction, [0001]. You can reference any single transaction by its number (i.e., “print 
3"), reference a range of transactions by putting a colon between numbers (i.e., “print 1:5"), 
or reference a multiple of individual transactions by numbers separated by a space (i.e., "print 


3:59"). 


CURRENT TRANSACTION 


Forum keeps track of the current transaction just as it keeps track of the current 
meeting. As you refer to other transactions, the last one you have dealt with is always the 
current transaction. Suppose you print transaction [0010]. When it has printed and the 
prompt waits for your next request, the current transaction is [0010]. When you then type 
“print +5", Forum prints transaction [0015], that is, current (which Forum knows without 
being told its number) plus 5 equals [0015]. You can use a minus sign (-) in the same 
manner. 
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Keywords 


Keywords let you refer to transactions without knowing their actual numbers. 


| RELATIVE ORDER KEYWORDS 


| Forum supplies keywords that let you refer to transactions by their relative order in the 
| proceedings. 


all, a 
refers to all transactions (same as first:last). 


current, ¢ 
refers to the transaction that was last printed, written or reset. 


first, f 
tefers to the first transaction in the proceedings. 


last, 1 
tefers to the last transaction in the proceedings. 


new 
refers to the transactions that you have not yet seen. 


next, n 
refers to the transaction immediately after the current transaction. 


previous, p 
refers to the transaction immediately before the current transaction. 


unprocessed, u 
refers to the unprocessed transaction (i.e., a transaction that you have typed 
but have not yet entered into a meeting). 


highest, last_seen 
refers to the highest-numbered transaction printed or written. 
CHAIN-TRACING KEYWORDS 
Forum also supplies keywords that specifically deal with transactions that have been 
linked together through the use of the “reply” request (described in Section 4). If you are 
trying to follow transactions in a chain (which are often not entered immediately following 
one another in a meeting), use these keywords: 


allref, aref 
refers to all transactions in the current chain of transactions. 


firstref, fref 
tefers to the first transaction in the current chain of transactions. 


lastref, lref 
refers to the last transaction in the current chain of transactions. 
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nextref, nref 
refers to the next transaction in the current chain of transactions. 


previousref, pref 
refers to the previous transaction in the current chain of transactions. 


restref, rref 
refers to all remaining transactions in the current transaction chain, but not 
including the current transaction. 


SEEN | UNSEEN TRANSACTIONS 


Forum remembers whether a user has seen each transaction, not just the most recent 
transaction that has been read. Forum uses the keyword "seen" and “unseen” to mark the 
transactions. For the following group of keywords, "seen" means that the transaction has been 
printed, written, or explicitly marked as seen by the switch_on request. "Unseen" means that 
the transaction has not been printed, written, of explicitly marked as seen by the switch_on 
request. 


seen 
tefers to all transactions marked as having been seen. 


first_seen, fs 
refers to the first transaction marked as having been seen. 


last_seen 
refers to the last transaction marked as having been seen. 


next_seen, ns 
tefers to the next transaction after the current one which is marked as seen. 


previous_seen, ps 
refers to the first transaction before the current one which is marked as seen. 


new 
refers to transactions entered after your last_seen transaction which were not 
entered by you. 


unseen 
tefers to all transactions not marked as having been seen. 


first_unseen, fu 
tefers to the first transaction not marked as having been seen. 


last_unseen, lu 
tefers to the last transaction not marked as having been seen. 


next_unseen, nu 
refers to the next transaction after the current one which is not marked as 
seen. 


previous_unseen, pu 


tefers to the first transaction before the current one which is not marked as 
seen. 
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THE CHAIRMAN'S MESSAGE KEYWORD 


The "chairman message” (cmse) keyword refers to the message or greeting that the 
chairman can set up when the meeting is created (or later, with the "set_message” request 
described in Section 8). It is the message printed the first time a user enters a transaction in 
a meeting. This transaction specifier can be used with the print and write requests. Only the 


chairman is allowed to use this specifier with the delete request. 


USE OF KEYWORDS AS REQUESTS 


All of the keywords except for "unprocessed" and "chairman_message” can also be used 
as requests. They print the number of the transaction(s) that the keywords refer to. The 
"next", "previous", "next_seen", "previous_seen", "next_unseen", and "previous_unseen" keywords 
and all of the keywords that reference chains can be given an argument to use as the current 
transaction. The argument to these requests must be a transaction number. Thus, "aref 4" 
returns a list of ail transaction numbers that refer to transaction [0004]: 


forum: ! aref 4 
k5 7 10 


forum: 


USE OF KEYWORDS AS ACTIVE REQUESTS 


An active request is a request enclosed in brackets that is first expanded to the 
transaction number(s) it represents before the entire request line is executed. For example, 
"print [aref 4]” expands to "print 4 5 7 10" thus printing all those transactions referring to 
transaction [0004]. 


USE OF KEYWORDS IN PLACE OF TRANSACTION NUMBERS 


All keywords except for “unproc", "all", "new", "restref", "allref", "seen", and "unseen" 
can be used in place of actual transaction numbers and can be combined with either "+" or 
"—"" as in “lref-1" or “nref+1". To reference from the current transaction use leading "+" 
and "-"; "-4" is the same as "current-4". To specify a range of transactions use two 
transaction numbers or keywords separated by a colon (:), as in “first:last” or "3:nref". 


Transaction Specification Control Arguments 


Control arguments are another type of transaction specifier that further restrict which 
transactions are selected by a request. A control argument is always preceded by a "-". They 
can be used to specify transactions that were authored by a certain person or that match a 
given character string. Control arguments can also be used to choose transactions based on 
deletion criteria or the date and time they were entered, or to specify that all the 
transactions selected be grouped together by chain. 
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DELETED TRANSACTIONS 


Several requests will operate on deleted transactions when the -include_deleted or 
~only_deleted contro! arguments are used. Forum considers only those transactions which the 
user can read, so for participants other than the chairman, only deleted transactions entered 
by that participant are considered. All of the chain_tracing keywords and the seen and 
unseen keywords can also use control arguments. Any of the following three control 
arguments can be used with a chain_tracing keyword or a seen or unseen keyword. 


-include_deleted, -idl 
print or return the index of the first unseen transaction in the meeting even if 
it is deleted. 


-only_deleted, —odl 
print or return the index of the first deleted unseen transaction in the meeting. 


-only_non_deleted, —ondl 
print or return the index of the first non_deleted unseen transaction in the 
meeting. (Default) 


PERSON_IDS 


The "-from Person_id" control argument indicates that only transactions authored by the 
person identified by Person_id should be selected. Thus, "-from LeeB" selects all transactions 
entered by the participant LeeB. Person_ids cannot contain the asterisk ("*") or period (".") 
characters. 


DATEITIME SELECTION 


The following control arguments select transactions according to the date and time that 
the transaction was entered. The strings DT, DT1, and DT2 are standard Multics date—time 
strings acceptable to the convert_date_to_binary_ subroutine (described in Mu/tics Subroutines 
and 110 Modules, Order No. AG93). Each must be enclosed in quotes if it contains spaces. 
(Examples are "8/19/83 1500.0 edt Fri", "August 8", "5:00 pm 21 May 1984", and midnight.) 


-after DT, -af DT 


ae tha Aan aon nni fin TH. <3... —£ 
selects all transactions entered on or after the the date specified. The time of 
day is ignored. 


~after_time DT, -aft DT 
selects all transactions entered after the date-time specified. 


-before DT, -—be DT 


selects all transactions entered before the date specified. The time of day is 


ignored. 


-before_time DT, —bet DT 
selects all transactions entered before the date-time specified. 


-between DT1 DT2, -bt DT1 DT2 


selects all transactions entered between the dates specified, inclusive. The times 
of day are ignored. 
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-between_time DTi DT2, -bit DTi DTZ 
selects all transactions entered between the date-times specified, inclusive. 


-date DT, -dt DT 
selects all transactions entered on the day specified. 


SORTING TRANSACTIONS BY CHAIN 


> The "-by_chain" control argument can be used to sort selected transactions into 
transaction chains if you are referring to more than one chain of transactions. This is useful 
when, for example, you want to write the last 50 transactions to a segment and you want 
those transactions to be grouped by transaction chain instead of the order they were entered 
into the meeting. 


Regular Expressions 


Simple regu/ar expressions are character strings enclosed in slashes (/). They are used 
for selecting transactions which contain a match for a given character string. The control 
arguments “-subject" (-sj) and "“-text" (-tx) can be given immediately before a _ regular 
expression to specify that matching is to be done only against the subject or the text 
respectively. By default, matching is done against both the subject and the text. For example, 
“list /television/" lists all transactions which contain the string “television”. 


If the regular expression contains spaces, square brackets, or parentheses, it must be 
enclosed in quotes. If it contains quotes, then the quotes inside the slashes must be doubled, 
and the entire regular expression must be quoted. The following is a list of valid regular 
expressions: 


/one/ 

“/one or/" 
/FOR/ 

/if/ 

" /character(s), /" 
"/He said, gts 


The null regular expression, //, signifies the last regular expression used. 
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The string is taken quite literally, ic, “/television/" will NOT match a transaction 
containing the string "Television". In order to ensure that case is not an issue, it is 


recommended that you use "/elevision/" which is still a unique enough string for matching 
only what you want. 


The following characters have specialized meanings when used in a regular expression: 


* 
signifies any number (or none) of the preceding character. 


when used as the first character of a regular expression, signifies the 
(imaginary) character preceding the first character on a line. 


when used as the last character of a regular expression, signifies the (imaginary) 
character following the last character on a line. 


matches any character on a line. 


For more information on regular i ia tefer to the Qedx Text Editor User's ‘Ss Guide, 
Order No. CG40. 


Examples 


The examples below show the use of Forum transaction specifiers combined with the 


“print” (p) request. You can use any of the other Forum requests that make sense in each 
case. 


p 14 
prints transaction 14. 
pu 
prints the unprocessed transaction. 
p +5 
prints the fifth transaction after the current transaction. 
p /budget/ 


prints all transactions containing the string “budget”. 


Trem 


p pil -from JBSmith 


prints all transactions in the range previous (p) through last (1) entered by 
participant JBSmith. 


p fref 
prints the first transaction in the current chain of transactions. 


p new 
prints all transactions not yet printed or written. 
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p l:c-5 /pli/ -from Baker 
prints all transactions in the range 1 through the Sth before the current that 
contain the string "pll" and were entered by participant Baker. 


p aref /solutions/ -from JohnB 
prints all transactions in the current reference chain that contain the string 
“solutions” and were entered by JohnB. 


p "/one or/" 
prints all transactions containing the string "one or". 


p aref —before 8/19/83 
prints all transactions in the current reference chain entered before 8/19/83. 


p unseen -after_time "2/2/83 12:00 pm” 
prints all transactions entered after noon on 2/2/83 which have not been 
printed or written. 

p —between 12/1/83 12/31/83 
prints all transactions entered in December 1983. 


Examples of transaction specifiers as requests: 


next 
returns the number of the next transaction: 
forum: ! next 
forum: 
In the above example, if the current transaction is 5, when the keyword "next" 
is used as a request, Forum returns "6", the number of the next transaction. 
previous 10 
returns the number of the transaction before transaction 10. 
fref 40 
returns the number of the first transaction in the same reference chain as 
transaction 40. 
aref first 


returns the numbers of all transactions that are in the same reference chain as 
the first transaction. 


next_seen [fu] 


returns the number of the first transaction that has been seen that was entered 
after the first transaction that has not been seen. 
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HOW TO STAY AWARE OF NEW TRANSACTIONS 


Once you begin to follow discussions in a meeting, you'll want to stay aware of new 
transactions in that meeting. You can find out which meetings have changed by using the 
"list_meetings" request with the "-changed" control argument: 


forum: ! Ism -changed 
Bulletin_board (bb) 
Everybody's Meeting (eve) 
Other_meetings (meetings) 


forum: 


This request line produces a list of all the meetings found via your forum search list in 
which new transactions have been entered since you last attended. 


If you add the -count control argument to the above request line, the output also tells 
you the number of new transactions in each meeting. 


You can also find out how meetings have changed by using the "check_meetings (ckm)"” 
tequest with the “-list, -—Is" control argument. The check_meeting request scans the forum 
search list looking for changed meetings (those with new transactions). To use the 
check_meeting request, type: 


forum: ! ckm -Is 

Changed meetings = 25 
Bulletin_board (bb) 3 
Everybody's Meeting (eve) 2 
Multics Picnic (mpic) 4 


forum: 


This request line returns the total number of changed meetings and produces a list of all the 
meetings found via your forum search list which have changed since you last attended. If 
you use the list (ls) contro! argument with the check_meetings request, the name of each 
changed meeting and the number of new transactions in each meeting is printed. 


You can then use the next_meeting request to successively view the changed meetingss in 
the list. The next_meeting request has the effect of doing a "goto" to the next meeting in 
the changed meeting list. 
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Another way to find out if a meeting has changed is to "goto" it. As mentioned above, 
when you enter a meeting for the first time Forum sets the current transaction to transaction 
[0001], because you haven’t seen any transactions yet. AS you read transactions, Forum resets 


tha army lamer n ana ~ mae eee ml an SL cpm ee mete 
your current transaction to be the last one that you have seen. In other words, if you enie 


a meeting for the first time and print the first ten transactions, the next time you enter that 
meeting your current transaction is [0010]. The transaction indicator keeps track of the 
current transaction (highest number seen) so that it can keep you informed of new 
transactions. This is done automatically and is relayed to you whenever you enter a meeting: 


forum: ! g bb 
Bulletin_board meeting: 2 new, 15 last. 
The meeting is public. 


forum: 


In the above example you can see that when you enter the Bulletin_board meeting, Forum 
tells you "2 new, 15 last". This means that you have seen the first 13 transactions already, 
and that 2 new ones have been entered since then--transactions 14 and 15 are new and you 
haven’t seen them yet. If you “list” the transactions in this meeting, you'll see that Forum 
prints an asterisk next to transaction 13, to indicate that 13 is your current transaction. When 
you enter a meeting, your current transaction is the last one you saw (highest-seen) when you 
last attended. You can reset your current transaction with the Forum "reset" request (see the 
forum command description in Section 7). 


If there is a burning issue being discussed in a meeting and you must be aware every 
time a new transaction is entered, tell Forum that you need immediate notification. The 
forum_accept_notifications (fant) command (described in Section 8) informs Forum from 
command level that, although you may not be currently attending, you want Forum to send 
you a message every time a new transaction is entered in the specified meeting for the 
duration of this login session. To specify which meeting(s) you want to receive notifications 
about, go to the meeting and turn the notify flag (or switch) on with the switch_on request: 


! fant 
r 09:59 0.216 23 


! forum 


forum: ! g personal_computers 
personal_computers meeting: 3 new, 5 last. 


forum: ! swn notify 


forum: 


The “switch_on notify” request line turns your notify switch on for that meeting, until 
you explicitly turn it off with the “switch_off" request. You can also set the switch from 
outside of the meeting by adding "-meeting personal_computers” to the end of the 
"switch_on" request line. 
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With the notify flag set to on, the next time someone enters a transaction in that 
meeting vou will receive a message of the form: 


From Fox.ProjA (forum) 05/18/82 1450.2 edt Tue: 
A new transaction has just been added to the 
>udd>ProjA>mtgs>personal_computers meeting. 


This message from Forum tells you that participant Fox entered a new transaction in the 
personal_computers meeting. But remember, you must issue the forum_accept_notifications 
command every time you log in, even though you need only issue the "switch_on notify" 
request once. Although the notify flag stays turned on permanently (until you request 
otherwise), each time you log in you must explicitly accept the notifications. The 
forum_accept_notifications command can be inserted in your start_up.ec. 


If you need no further notifications, use the "switch_off notify” request to turn the 
notify flag off. If you want to leave the flag turned on but do not wish to receive further 
notifications in your current login session, use the forum_refuse_notifications (frnt) command 
(described in section 9). 


INTERRUPTING LENGTHY OUTPUT 


When you ask for a list of all transactions in a meeting (or anything that fills your 
screen with output), occasionally you may decide that you do not want to wait for all the 
lines to be printed. You can interrupt processing of your request by pressing the QUIT key 
(sometimes labeled ATTN, BREAK, or INTERRUPT). This action takes you out of Forum 


2 TT noe 


and back to command level; Multics prints QUIT and a ready message containing the word 
"level" and a number. Type the Multics command “program_interrupt” or. “pi” (described in 
the Commands manual) to reenter Forum. Your request has been aborted; now you are in the 
Tequest loop and can issue another request. (At this point, the current meeting is still the 
same as before you QUIT. 


forum: ! list 


Trans# Lines Date Time Author Subject 
[0001] (5) 05/18/81 03:20 Brooks.ProjA Reason for this meeting 
[0002] (3) 05/20/81 03:46 Davis.YAK Fortran for a Begin<More> 


[0003] (3) 05/21/81 06:49 Smith.ProjB Other Meetings 


QUIT <USER PRESSED THE INTERRUPT KEY HERE> 
r 14:00 11.304 534 level 2 

! pi 

forum: 
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SECTION 4 
SPEAKING 


Once you get the irresistible urge to speak in a meeting, you can choose one of two 
Forum requests to do so: 


e “talk" if you want to speak about a new topic. 


e "reply" if you want to respond to an earlier transaction. 


This section describes how to use these requests, how to edit your transaction before 
entering it into a meeting, how to delete and retrieve any transaction that you've authored. 


OPENING A NEW TOPIC--THE TALK REQUEST 


If you are currently attending a meeting and have something new to say, use the “talk” 
(t) request. Forum prompts you for the subject of the transaction: 


forum: i! taik 
Welcome to Everybody's Meeting 
Subject: 


The message “Welcome to Everybody’s_Meeting" is the chairman’s greeting message which, if 
set by the chairman, appears the first time you speak in a meeting. (See the "chairman_message” 
transaction specifier in Section 3.) After the "Subject:" prompt, type in a title and another 
carriage return. Now Forum responds with another prompt, indicating that you can proceed 
with the text of your transaction. 


forum: ! talk 

Weicome to Everybody's Meeting. 
Subject: ! home computers meeting 
Transaction: 


AS you type in your transaction, keep in mind that the # and @ characters are always 
available for correcting or erasing characters in the line you are currently working on. 


If you’re satisfied with entering your transaction as is, without editing it, then the 
simplest way to conclude your transaction is to type a period alone on a line, and then a 
carriage return. As soon as you do this, the transaction is entered into the meeting, and you 
teceive a confirmation of the form, "Transaction [0015] entered into Everybody’s_Meeting.” 
This is followed by the Forum prompt, indicating that you have been returned to Forum 
Tequest level. 
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Here is an example of building and entering a transaction while attending a meeting. 
Note the use of the # character to correct a mistake in the message text. 


1 Or wine ! taik 

Welcome to Everybody's Meeting. 
Subject: ! home computers meeting 
Transaction: 

Is there sufficient interest too# 
create a meeting for home 
computers? t#To help solve 
problems, some sort of information 
exchange might be useful. 

Any takers?? 


Transaction [0015] entered in >udd>ProjA>Everybody's Meeting meeting. 


forum: 


When you end your transaction with a period, however, you miss the chance to check 
and edit it before it is entered into the meeting. Forum has a built-in text editor that gives 
you an easy way to edit your transactions before entering them (see “Editing Your 
Transaction” below). na 


COMMENTING ON AN OLD TOPIC--THE REPLY REQUEST 


As we know, the pleasure of a "real" meeting is not just speaking or hearing the 
comments of: others, but agreeing with wonderful ideas and challenging the mediocre ones. 
The Forum "reply" (rp) request works much the same as talk, except that your subject line 
contains an. automatic reference to the transaction you are replying to, instead of a new 
subject. Assume that you have just printed transaction 15, shown above, regarding 
home_computers and wish tO show your support: 


forum: ! reply 15 

Subject: Re: home computers meeting 
Transaction: 

! Yes, | second the motion! 

! e 

Transaction [0016] entered in >udd>ProjA>Everybody's Meeting meeting. 


forum: 


The reply request assumes the subject of the reply to be a reference to the subject line 
of the transaction you are replying to. You are then prompted for the text of your reply 
("Transaction:”). 
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Once your reply is entered, it is linked to the transaction to which it is a reply, 
forming a transaction chain. Transaction chains are very easy to follow via the keywords 
specifically designed to follow the progress of chains (see "Chain-tracing Keywords” in Section 
3). 


EDITING YOUR TRANSACTION 


Forum offers two built-in editors to allow you to change, delete, and add to your 
transaction while you remain in Forum. You can enter them by typing either “qedx" (or qx) 
to enter the Qedx editor or "ted" to enter the Ted editor. 


The Qedx editor is introduced in the New Users’ Introduction--Part I, and explained 
fully in the Qedx Text Editor Users’ Guide (Order No. CG40). You are strongly 
encouraged to turn to one or both of those manuals, because this manual contains only a 
review of the simplest subset of editor requests. 


Ted is a slightly more sophisticated editor than Qedx, and offers powerful requests and 
macro capabilities. See the Mu/tics Text Editor (TED) Reference Manual (Order No. CPS50) 
for a complete description of this editor. In the examples shown in this section, the qedx 
request is used, although you can use the ted request similarly to accomplish the same tasks. 


When you are first typing in your transaction and you want to make ae type \f 
alone on a line (instead of a period): 


Transaction: 
! <text as shown above> 
! Any takers?? 


1 \f 


This enters you into the Qedx editor where you can clean up your transaction. 
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Editor Requests~ ~Qedx 


Once you are in the editor, you issue editor requests as opposed to Forum requests. 
Here is a list of basic editor requests (the "$" means the last line in your transaction, 
regardless of its line number): 


REQUEST DESCRIPTION EXAMPLES 
p prints the specified line(s) p 2p 1,3p 
= prints the line number of the = $= 
specified line 
d deletes the specified line(s) d 3d 1,$d 
a adds lines of text after the a 2a 
specified line 
s/old/new/ substitutes every occurrence of s/hte/the/ 
the first character string with 1,$s/11:00/9: 30/ 


the second character string, on 
the specified line(s) 


s/old/new/p same as above, but also prints s/hte/the/p 
- the changed line 


To leave the gedx editor, type w (write) to save the changes, and then q (quit) to 
return to the Forum request loop. The write request may be used as often as desired to 
checkpoint the editing process. Note that these are qedx editor requests, not Forum requests 
{the Forum quit request is described under “Exiting Forum" in Section 2; the Forum write 
request is described under "Writing Transactions" in Section 3). 


If the quit (q) request is issued and the transaction has been modified since it was last 
written, the editor will query for permission to exit. If permission is given, any changes 
made since the last write request will be lost. The quit-force (qf in qedx or q in ted) 
request can be used to abort unwanted editing of the transaction without being queried. 


To restore the original transaction text after you have made changes but before you 
issued a write request, type "l,$dr". If you did issue a write request, this sequence will 
Testore the text as it was last written. 


Below is an extended example of how the transaction shown above might have been 
constructed. Supplemental comments are displayed to the right of the example. ai that 
would not necessarily be in an actual session are included here for clarity. 
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forum: ! talk 
Subject: ! home computers meeting 


Transaction: 

Is there sufficent interest <a first draft> 
create a meeting for home 

cmoputers? To@ 

computers? To help solve 

problms some sort of information 

exchange might be useful. 

Any takers?? 

\f <enter edit mode> 


nee Sam Cum com Om sme Cams comm 


is/ce/cie/p <correct one spelling error> 
Is there sufficient interest 


! s/est/est to/ <add more> 


! 1,$p <print entire message> 
Is there sufficient interest to 
create a meeting for home 


computers? To help solve 

problms some sort of information 
exchange might be might be useful. 
Any takers?? 


<-- 
i 5 <print line 5> 
problIms, some sort of information | 
i s/ims/lems/p _ <correct another error,> 


problems, some sort of information < and print the line > 


! 3d <delete empty line> 

! ow <save the changes> 

1g <leave editor> 
forum: 


You are now in possession of an unprocessed transaction. You can issue other requests 
(i.e., “print” to have another look at it), or further manipulate it. Maybe you want to adjust 
the margins or change the subject line. See the next section for more options to use on 
unprocessed transactions. 


If you have typed in a new transaction and do not require the editor at this time, but 
you do not want to enter it into the proceedings of the meeting just yet, end your input 
with "\q" (instead of "." or "\f"). This puts you back at Forum request level where you can 
issue other requests to manipulate your unprocessed transaction. 
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! forum: ! talk 

Subject: ! home computers meeting 
Transaction: 

<Text as shown above> 


! \q 


forum: 


Once you are satisfied with the contents of your transaction, issue the "enter" (en, send) 
Tequest to enter it in the proceedings of the current meeting. 


You can modify the contents of an unprocessed transaction in a number of ways but 
once you enter the transaction in a meeting, it is no longer unprocessed and you can no 
longer manipulate it. At request level, you can issue requests that will print, format, re-edit, 
and otherwise perfect the text of your unprocessed transaction. 


Using the Emacs Editor 


If you prefer, you can edit your unprocessed transaction with the Multics Emacs text 
editor, a display-oriented editor designed for use with video terminals. You can call Emacs 
from within Forum via the "apply" (ap) request: 


forum: ! apply emacs 
<system enters Emacs, showing transaction in buffer> 


This places your unprocessed transaction in an Emacs buffer where you can edit it. You must 
save any changes with the Emacs write request (4X“S) and quit the editor with *X4C. Once 
you quit the editor, you are returned to the Forum request loop where you can enter your 
transaction with the "enter" (e) request. 


For a complete description of the Emacs editor, see the Emacs 7ext Editor Users’ 
Guide, Order No. CH27. 


ENTERING A PRE-WRITTEN TRANSACTION 


The talk and reply requests accept the "-input_file" (-if) control argument which allows 
you to enter a free-standing segment as the text of your transaction. Forum automatically 
supplies the header information, and (with the talk request) prompts you for the subject. For 
instance, if your comments were contained in a segment named “home_computers_talk" they 
could be entered in this way: 


forum: ! talk -if home_computers_ talk 
Subject: ! home computers meeting 
Use the "enter" request to enter the transaction. 


forum: 


Notice that you are now in possession of an unprocessed transaction. Forum reminds 
you to use the enter request io enter it into the proceedings of the meeting. 
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HANDLING AN UNPROCESSED TRANSACTION 


If you have an unprocessed transaction and you "goto" a different meeting, Forum tells 
you that you left something behind: 


forum (goto): Warning, there is an unprocessed transaction in the 
Everybody's Meeting meeting. 


In the above example, you built the transaction in "Everybody’s_Meeting" and then attended a 
different meeting without first entering the transaction. The warning message reminds you 
that there is an unprocessed transaction to deal with—-probably you'll want to enter it in 
"Everybody’s_Meeting" from your current location ("en -meeting eve") or throw it away ("dl 
unproc"). 


You can use the "." (current) request: to check the subject and number of lines in your 
unprocessed transaction. For example, if you’re attending the meeting in which you created 
the transaction, the output resembles this: 


forum: ! 

forum 1.8: 72 new, 277 last, 205 current. 

Attending the >udd>ProjA>forum>Everybody's Meeting meeting. 
1 line unprocessed. 

subject: home computers meeting 


forum: 


If you’re attending a meeting other than the one in which you built the unprocessed 
transaction, the output tells you where that transaction is: 


forum: ! . 

forum 1.8: 0 new, 8 last. 

Attending the >udd>ProjA>mtgs>0Other_Meetings meeting. 
1 line unprocessed in the Everybody's Meeting meeting. 
subject: home computers meeting 


forum: 


If you attempt to exit Forum via the "quit" request while you have an unprocessed 
transaction, Forum warns you that you have an unprocessed transaction (which will be thrown 
away if you quit now) and asks you if you really want to quit before entering your 
transaction in a meeting. 


Manipulating Your Transaction 


If you print your unprocessed transaction, you will see question marks in place of a 
transaction number. Remember that if you don’t end a transaction with a period when you 
first type it in, you must explicitly enter it before you exit Forum, or else Forum throws it 
away. Use the Forum "enter" (en, send) request to enter an unprocessed transaction. 
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THE PRINT REQUEST 


The forum "print" (p) request displays text of the transaction preceded by a version of 


the transaction header that indicates an unprocessed transaction. The example transaction, 
which is your current transaction, is used for illustration: 


forum: ! p 

(777?] (3 lines) Your_name.Your_project **UNPROCESSED** 
Subject: home computers meeting 

Is there sufficient interest to 

create a meeting for home 

computers? To help solve 

problems, some sort of information 

exchange might be useful. 

Any takers??? 

---[2?272?7]--- 


forum: 


THE FILL REQUEST 


The "fill" (fi) request reformats the text of your transaction by adjusting the right 
margin so that no line has more than a certain number of characters. By default, the 
maximum line length is set at 72 characters but if you prefer, you can specify another length 
with the -line_length (-1l) control argument followed by the maximum number of characters 
you want on a line. 


forum:: ! fill -11 50; p 

[72727] (4 lines) Your_name.Your_project **UNPROCESSED** 
Subject: home computers meeting 

Is there sufficient interest to create a meeting 

for home computers? To help solve problems, some 

sort of information exchange might be useful. Any 
takers??7 

~--[7777]--- 


forum: 
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THE SUBJECT REQUEST 


The "subject" (sj) request can be used to print the subject of your unprocessed 
transaction: 


forum: ! 

Suppose you decide that you want to change the subject of your 
transaction. The subject request can also be used to change the subject. 
If the new subject contains spaces, it must be quoted. 


forum: ! subject "Personal Computers" 


forum: ! subject 
Subject: Personal Computers 


DELETING TRANSACTIONS 


Transactions can be deleted (and retrieved) as described below. 


The delete Request 


You can delete any transaction that you have entered, for whatever reason, by using the 
Forum "delete" (dl) request, making the transaction unavailable to other participants. Only you 
and the meeting chairman have access to them. Only the chairman can delete a transaction 
authored by someone else. Your deleted transactions can be read again’ with the list, print 
and write requests if you give the -include_deleted or. -only_deleted control arguments to 
these requests. 


Deleted transactions remain deleted indefinitely but also remain accessible to you until 
the chairman issues the "expunge" request which kills deleted transactions permanently. (See 
“expunge” in Section 7.) 


The retrieve Request 


It is also possible, once you have deleted a transaction, to retrieve it again and thus 
Te-enter it into the meeting. The "retrieve" (rt) request does just that. Only transactions that 
were deleted by you (and therefore authored by you) can be retrieved by you. Only the 
chairman can retrieve a transaction deleted by someone else. See the full description of the 
retrieve request in Section 7. 


If the chairman has issued the "expunge" request since the transaction was deleted, then 
it cannot be retrieved. 
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SECTION 5 


HOW TO GET HELP 


Forum supplies several help requests that give you information about Forum requests in 


graduated levels of detail. 


THE ? REQUEST 


When you forget the short name of a request or need to be reminded of the names of 
any of the basic requests, use the "?" request. It prints a memory-jogging list of the most 


important requests. 


goto, g, go 

list, Is 

print, p, pr 

quit, q 

add _ meeting, am 
announce_meeting, anm 
announcement_info, ai 
apply, ap 

chairman, cm 
check_meetings, ckm 
current_meeting, cmtg 
delete, dl, d 


enter, en, send 
fill, fi 
forum_dir, fd 
list_meetings, Ism 
list_users, lsu 
mai | 

next_meeting, nm 
qedx, qx 
remove_meeting, rm 


reply, rp 


reset, r 


retrieve, rt 
subject, sj 
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switch_off, swf 
switch_on, swn 
talk, t. 

ted 

write, w 

help 

list_help, Th 
list_requests, Ir 
abbrev, ab 
exec_com, ec 

do | 

if 

answer 

execute 
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THE LIST_REQUESTS REQUEST 


The "list_requests" (Ir) request gives you a one-line description of each Forum request. 
It also tells you how you how you can send a command line to Multics from within Forum 


and how you can get more detailed help on any of the requests in this list. 


forum: ! list_requests 
Summary of forum requests: 


Use ''. .COMMAND_LINE" to escape a command line to Multics. 
Type "list_help" for a list of topics available to the help request. 
Type "help TOPIC" for more information on a given topic. 


Print current status. 


help Obtain detailed information on forum. 
list_help, th List topics for which help is available. 
list_requests, Ir List brief information on forum requests. 
quit, q Exit forum. 

goto, g, go Enter a meeting. 

print, p, pr Print the specified transactions. 

list, Is List the specified transactions. 

abbrev, ab Turn abbreviation precessing on or off. 
forum: 


There are many more requests that normally appear in the list but are not displayed in 
this example. 


THE LIST_HELP REQUEST 


The "“list_help"” (Ih) request gives you a list of every single possible Forum request, or a 
list of requests related to the TOPIC that you name. For example: 


forum: ! list _help ready 
Topics available for forum: 


ready off 
ready_on 
ready 


forums: 


You can ask for detailed, specific help on any topic returned by list_help by naming it as 
the TOPIC argument to the "help" request (described below). 
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THE HELP REQUEST 


For detailed information on how to use a particular Forum request, type “help” 
followed by the name of the request. (ie, “help reply"). The “help” request offers compiete 
information on every Forum request and on other selected topics concerning Forum. 


The "help" request enters you into a sub-request loop, asking you at several points if 
you want more information ("More help?"). The most basic answers to this prompt is either 
“yes" or "no". A response of "2" gives you a list of all possible answers known to the help 
request. For a more detailed explanation of the help request, see Section 8. 


t 


WHERE AM !? 


If you’ve lost your place in the request loop, you can find out exactly where you are 
at any time with the Forum "." (dot) request. If you are not currently attending a meeting, 
it simply gives you Forum’s version number: 


forum: ! . 
forum 1.10 


forum: 


If you are attending a meeting, it tells you the location of the meeting and transaction 
information in addition to Forum’s version number: 


forum: ! . 
forum 1.10: 9 new, 10 last. 
Attending the >udd>ProjA>forum>Everybody's Meeting meeting. 


forum: 


If you have seen some, but not all, of the transactions in this meeting, this request gives you 
the number of the last transaction you saw. 


This request aiso ielis you if you have any unprocessed iransaciions (unprocessed 
transactions are created when you speak in a meeting--they are fully described in Section 4). 
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SECTION 6 
ADVANCED FORUM FEATURES 


Many of the Forum components already discussed, such as control arguments on the 
command line, transaction editing, and powerful request language, have additional features that 
enable you to use Forum to perform more specialized functions. These advanced techniques 
derive their strength by using command level capabilities from within Forum. 

CONTROL ARGUMENTS AND REQUESTS 

Almost all Forum requests take control arguments. Here are some examples showing a 
specialized usage of the list_users request. 

To find out if the user JPSea is a participant of the current meeting, type: 


forum: ! Isu -user JPSea 


and if she is, Forum prints the summarization line showing last transaction seen, last time 
attended, and any flags for JPSea. 
To get a listing of all users who are currently attending the meeting, type: 


forum: ! Isu -attending 


ACTIVE REQUESTS 


An active request is a request line enclosed in brackeis that is firsi expanded to its 
return value before the entire request line is executed. The following is a list of Forum 
active requests: 


current_meeting, cmtg list_meetings, Ism 
do list_users, lsu 
exec_com, ec next_meeting, nm 
execute, e subject, s} 
forum_dir, fd subsystem_name 
if subsystem_version 
list, Is 
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The “cmtg" active request returns the pathname of the current meeting you are 
attending. Wherever you type "[cmtg]" on a request line, Forum replaces that with the name 
of the current meeting. One way of using this active request is: 


forum: ! write -pn [cmtg] 
which places the current transaction in a saved segment with the name of the current meeting 


as its name. 


With the "e" active request, you can incorporate Multics active functions into Forum 
request lines. Here are a few examples: 


forum: ! write 3 -pn [e home_dir]>feline 
for saving transaction [0003] in a segment named "feline" in your home directory; 


forum: ! Ism -part -user [e last_message_sender] 


for determining which meetings the user who last sent you an interactive message participates 
in; 


forum: ! pr -date [e date] 


for printing all transactions in the current meeting that were entered today. 
For a detailed discussion of the usage of each active request, refer to section 8. 


ESCAPING TO COMMAND LEVEL 


There are several ways to use the Multics command environment while you remain 
inside Forum. This ability can be handy for a variety of purposes. 


The ..command_line Escape 


To issue a Multics command within Forum, simply type two periods directly after the 
prompt, followed by the command line: 


forum: ! ..who 


When the command has finished, you receive another Forum prompt. 


You can use this escape to check on which saved transactions you have in your 
directory ("..list") and to attend to other Multics activities when they occur to you ("..sm 
Brie.ProjDog Let’s eat.") without having to end your Forum session prematurely. 
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You are free to use any command language conventions and facilities in the same way 
vou do outside Forum. Active functions (discussed in the New Users’ Introduction—-Part I1) 
are especially useful in providing the command language with extra flexibility. Here are two 
examples: 


forum: ! ..sm [last_message_ sender] Sure, |'m hungry too 
forum: ! ..eor [home_dir]>canine.mai 


Standard quoting and semicolon conventions also apply when using the .COMMAND_LINE 
escape. 


Forum requests and active requests can not be used with the "..” request. The command 
line is made up of Multics commands and active functions only. 


The execute Request 


The "execute" (e) request performs a function very similar to that of the .COMMAND_ LINE 
escape, because it also passes the rest of the line to command level to be acted on. Before 
the command line reaches command level, however, it passes through the Forum request 
processor. This means that all forum active requests (which are enclosed in brackets as 
described above) get processed first. The results are placed in the request line, and then the 
line gets processed as a command line. To illustrate with the cmtg active request, which 
returns the pathname of the meeting you are currently attending, you can type: 


forum: ! execute list [emtg].trans 


which expands to: 


forum: execute list Everybody's Meeting.trans 


to see whether you have saved any transactions with the default name of the current meeting. 


CONDITIONAL EXECUTION (THE IF REQUEST) 


There may be times when you want to execute a request only on certain conditions, or 
execute a request if a condition is met and another if it is not met. The forum "if" request 
allows you to conditionally execute one of two request lines depending on the value of a 
returned active string. For exampie: 


forum: ! if [e exists seg [cemtg].trans] -then "e dl [cmtg].trans; w new'' 
-else ''w new'' 


which asks if a segment named <current_meeting>.trans exists in your working directory, then 
delete it and write all the new transactions in the current meeting to the default segment 
named <current_meeting>.trans. If the segment does not exist, then simply write the new 
transactions to the segment. The active strings being expanded here are Forum active requests. 
Thus, to execute a Multics active request, the "e" active request must be used. The actions to 
take follow the -then and -else control arguments, and they must be enclosed in quotes if 
they contain spaces or other command language characters. If the "~else" action is not 
specified and the condition returns "false", no action is taken. 
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The if active request returns one of two character strings to the Forum request 
processor depending on the value of an active string. For example, 


forum: ! write all [Lif [Le equal [subsystem_version] 1.10] 
-then "-by_chain -format" -else "-fill"] 


which will execute the request line "write all -—by_chain -format" if the subsystem_version is 
1.10, or "write all -fill" if it is not 


THE MAIL REQUEST 


If you want to send a transaction or set of transactions to other users, mailing lists, or 
Forum meetings you can use the forum mail request. To send transactions to another user: 


forum: | mail 10 11 12 -to McElvenny.Pubs 
be 


Mail delivered to McElvenny.Pubs 


forum: 


This request line sends transactions 10 through 12 to the mailbox of McElvenny.Pubs. Within 
the mail system the User_id is considered one form of address, because the mail system uses 
this information to deliver the transactions to the correct mailbox. 


To send transactions to Forum meetings: 


forum: ! mail 10 11 12 -to -meeting >site>forum_dir>picnic_talk 
! s 
Mail delivered to >site>forum_dir>picnic_talk 


forum: 


This request line sends transactions 10 through 12 to the picnic_talk forum meeting. If you 
give just an entryname (no ">" or "<" characters) instead of the absolute pathname, the 
forum commands search path is used to find the meeting. For more information on the mail 
request, see "Forum Request Description" later in this manual. For more information on the 
Multics mail system, refer to the Mu/tics Extended Mail System Users’ Guide, Order No. 
CH23. 


THE FORUM COMMAND 
Many forum command control arguments have been described in earlier sections of this 


manual. They allow you to personalize your Forum environment. All of the forum command 
control arguments are described in the forum command description in Section 8. 


To illustrate a few simple possibilities, here are some sample command lines using some 
control arguments that have not previously been discussed: 


forum -meeting mgr_meeting -list -quit 
forum -abbrev -brief 
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The first Forum command line above enters Forum, goes to the mgr_meeting meeting, lists all 
transactions, and quits, returning you directly to command level. The second example invokes 
Forum with abbreviation processing turned on and the briefest form of the Forum messages 
are to be printed. 


forum -prompt Next -output_fill 
forum ~meeting pubs -no_prompt 


The first example above enters Forum, prompts you with "Next" instead of "forum:" and fills 
all transactions before writing or printing them. The second example enters the pubs meeting 
and asks that you not be prompted at all in the request loop. 


forum -meeting mgr_meeting -rq "write new -pn [e hd]>my; quit" 


This command line enters the mgr_meeting meeting, writes any new transactions into a 
segment named my.trans (in your home directory), and exits Forum. 


USING ABBREVIATIONS 


If you are using one particular Forum command line frequently, you will find that 
creating an abbreviation for the command line, with the abbrev command, is a much simpler 
way of specifying that information. Here is how to use the abbrev command to make an 
abbreviation for one of the example command lines above: 


! .ab my_forum forum -prompt Next -output_fill 
Now when you want to enter forum with "Next" as your prompt, and ito have your 
transactions filled on output, type "my_forum". In the example above, it is assumed that you 
have abbreviation processing turned on for your process. Refer io the New Users’ 
Introduction——Part II for details concerning the abbrev command and the creation of 
abbreviations. 
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There is a whole set of “inverse” contro] arguments that are useful for reversing the 
effect of one (or more) of the control arguments you have included in an abbreviation. If 
for example you do not always want your transactions filled on output, you can type 
"“my_forum -no_output_fill" which is expanded into the command line: 


forum -prompt Next -output_fill -no_output_fil 


Whenever conflicting control arguments appear on a command line, Forum uses the last one 
to appear. Thus the above example restores the default filling action. 


The abbrev Request 


Abbreviations are a shorthand version of an otherwise lengthy or often-used request 
line. You must either use the -abbrev control argument when you invoke forum or use the 
Forum "abbrev" request to initiate abbreviation processing within the current Forum session. 
Forum abbreviations can either be defined at Multics command level or from within Forum 
via the ".." request. 


You may want to define an abbreviation for the "talk" request, such as the one shown 
below which, upon termination of input, places your unprocessed transaction in an’ Emacs 
buffer for editing: 


! .ab T do "talk -rql; apply emacs" 


This abbreviation contains two request lines, thereby requiring the use of the "do" command. 


FORUM EXEC_COMS 


If you have specific’ sets of Forum requests that you use frequently, you can put them 
together in an exec_com segment which can be executed via the Forum "exec_com" (ec) 
request. The Forum exec_com segment can be written in either version 1 or version 2 
exec_com (see the Commands manual) and must have the suffix of ".fmec". It is just like a 
Multics exec_com segment except that it contains forum request lines instead of Miultics 
command lines. This means that to execute Multics commands from within the exec_com, you 
must use the "execute" request, and with Multics active functions, use the "e" active request. 
The following example shows the contents of a forum exec_com, and the method of executing 
it: 


Contents of [home_dir]>sample_ec.fmec: 


(1) &command_line off 

(2) e cwd [e hd] 

(3) goto &] 

(4) if [e exists seg [cmtg].trans] -then "e dl [emtg].trans" 
(5) ow onew -after "Sunday - Iweek'' -format -by_chain -bf 

(6) e eor [cmtg].trans 

(7) &quit 


forum: ! ec sample_ec eve 
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The "sample_ec.fmec" program executes the following: 
(1) changes your working directory to your home_dir. 


(2) goes to the meeting you specified as an argument to the exec_com request 
("eve"). 


(3) checks to see if a segment named “Everybody’s_meeting.trans” exists in your 
home directory and if it does, delete it. 


(4) writes all new transactions that were entered after Sunday (i.e., this week’s new 
transactions) to a segment with the default pathname of 
{home_dir] >Everybody’s_meeting.trans. The transactions are sorted by chain, 
formatted for output, and no message is printed if no transactions were 
selected. 


(5) prints the segment on the default line printer. 


The forum request: 


forum: ! ec sample_ec ([1sm -changed]) 


executes the sample_ec exec_com for every meeting that has changed as returned by the 
list_meetings active request. 


Forum searches the “exec_com™ search list for segments with the ".fmec” suffix. An 
absolute pathname can also be specified which bypasses the search facility. 


The Forum Start_up Exec_com 


When forum is invoked, it searches for a start-up segment with the name "start_up.fmec”. 
The start_up exec_com creates a specially tailored forum environment every time you enter 
forum. This segment is a Forum exec_com segment written in either version 1 or version 2 
exec_com with Forum request lines. A sample start_up.fmec segment written in version 1 
exec_com is shown below. 


&command_line off 

ab 

lsm -changed -no_adjourned -long 
&quit 
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This start_up turns on abbreviation processing and lists all meetings in which you are a 
participant that have changed, not including adjourned ones. If no meetings have changed, the 
message "No meetings have changed” will be printed instead. If you supplied the name of a 
Meeting to attend on the forum command line, this information will be printed before 


entering the specified meeting and being placed in the forum request loop. 


The directories that are searched for start_up.fmec are your home directory, your 
project directory, and >site, in that order. 


The forum command allows you to bypass execution of the start_up exec_com with the 
"—no_start_up” control argument. 


FORUM AND YOUR PROCESS START_UP 


Another method of setting up your own Forum environment is to piace a Forum 
command line at the end of your process start_up exec_com segment. For example: 


fant; forum 


tells Forum that from the time you log in, you want to be notified of any new transactions 
in any meetings where you have previously asked for immediate notification of new 
transactions (with the switch_on request). The rest of the command line tells Multics to enter 
you immediately into Forum while executing your process start_up. 
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SECTION 7 
FORUM REQUEST DESCRIPTIONS 


This section contains descriptions of the Forum requests, presented in alphabetical order. 
These requests are for all users except where otherwise noted. Each description contains the 
name of the request (including the abbreviated form, if any), discusses the purpose of the 
tequest, and shows the correct usage. Notes and examples are included when deemed necessary 
for clarity. The discussion below briefly describes the content of the various divisions of the 
request descriptions. 


Name: 


This heading lists the full request name and its abbreviated form. 


Syntax 

This part of the request description shows a single line that demonstrates the proper 
format to use when using (invoking) the request. Any elements in the line that follows the 
name of the request are explained under subsequent headings. 
The following conventions apply in the syntax line: 


1. Optional arguments are enclosed in braces (e.g., {path}, {User_ids}). All other 
arguments are required. . 


2. Control arguments are identified in the usage line with a leading hyphen (eg., 


_ {-control_args}) simply as a reminder that all control arguments must be 
preceded by a hyphen in the actual invocation of the request. 


Function 

This heading discusses the purpose and function of the request and what happens when 
you use it. 
Arguments and Control Arguments 

These headings describe the other elements shown in the "Syntax" line, which tell Forum 
exactly what it should perform the request on, and specifically how it should be performed. 


Common arguments are meeting_name (the name of the meeting), STR (any character string), 
and N (an integer). . 
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Control arguments are always preceded by a "—" character, and are typed as you see it 
(i.e, -off, -on). They sometimes have a short name as well as a long name (ie., —brief, 
-bf). Some control arguments also have another argument associated with it as in "-date DT” 
where DT is a date-time value (ie., —date "08/30/83 11:30 edt"). If any of these arguments 
contain spaces, parentheses, or quote characters, they must be enclosed in quotes. 


Notes 

Comments or clarifications that relate to the request as a whole are given under the 
"Notes" heading. Also, where applicable, the required access modes, the default operation 
(when invoked without arguments), and any special case information are included. 
Examples 

The examples show different valid invocations of the request. An exclamation mark (!) 
is printed at the beginning of each line typed by the user. This is done only to distinguish 
user-typed lines from system-typed lines. The results of each example request line are either 
shown or described. . 
Other Headings 

Additional headings are used in some descriptions, particularly the more lengthy ones, to 


introduce specific subject matter. These additional headings may appear in place of, or in 
addition to, the notes. 
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. (current) . command line 


Name: . (current) 


SYNTAX 


FUNCTION 


prints information about the current version of Forum, the meeting the user is attending (if 
any) and the unprocessed transaction (if any). The format of the output is: 


forum 1.8: 0 new, 220 last, 220 current. 

Attending the >udd>Company>meetings>excursions meeting. 
12 lines unprocessed. 

subject: Re: picnic 


If the user is attending a meeting, the number of new (unseen) transactions, the transaction 
number of the last transaction, and the number of the current transaction are printed. If the 
user has built a transaction but not yet entered it into a meeting, the subject and number of 
lines in that transaction are printed. If the user is about to enter an unprocessed transaction 
in a meeting other than the current meeting, this request also prints the name of the meeting 
that the transaction will be entered in (e.g, “12 lines unprocessed in the eve meeting.” if 
attending the excursions meeting but entering a transaction in the eve meeting). 


Name: ..command_ line 

SYNTAX 

--command_line 

FUNCTION 

executes a Multics command line from within the Forum request loop. 
ARGUMENTS 

command_line 


is any Muitics command iine. When the command has executed, you are returned to the 
Forum request loop. 
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abbrev abbrev 


Name: abbrev, ab 

SYNTAX 

ab {-control_args} 

FUNCTION 

controls abbreviation processing within Forum. 
CONTROL ARGUMENTS 


~off 
specifies that abbreviations are not io be expanded. 


-on 
specifies that abbreviations should be expanded. (Default) 


-profile PATH 
specifies that the segment named by PATH is to be used as the profile segment; the 
suffix ".profile" is added to PATH if not present. The segment named by PATH must 
exist. 


NOTES 


Forum provides command line control arguments (-abbrev, —-no_abbrev, -profile) to the forum 
command to specify the initial state of abbreviation processing. 


If invoked with no arguments, this request enables abbreviation processing within Forum using 
the profile that was last used in this Forum invocation. If abbreviation processing was not 
previously enabled, the profile in use at Multics emmane level is used; this profile is 
normally [home_dir] >Person_id.profile. 


See the abbrev command in the Commands manual for a description of abbreviation 
processing. 
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add_ meeting add_ meeting 


Name: add__meeting, am 

SYNTAX 

am {trans_specs} {meeting_names} {-control_args} 
FUNCTION 


adds meetings to the user’s forum search list by placing links to them in the directory 
>udd>Project>Person>meetings and makes the user a participant in the meeting. 


ARGUMENTS 


trans_specs 
are transaction specifiers identifying transactions created by the announce_meeting request. 
If any trans_specs are given, they must precede all meeting _names. At least one 
trans_spec or meeting name must be given. For more information on _ transaction 
specifiers, refer to "Reading Transactions” later in this manual. oe 


meeting_names 
are pathnames of forum meetings to be added to the search list. 


CONTROL ARGUMENTS 


—current_meeting, ~cmtg 
adds the current meéting io the search list. 


-directory PATH, -dr PATH 
places the links in the specified directory instead of the default directory of 
>udd>Project>Person>meetings. 


~force, -fc 
adds the link even if the user is not eligidie to participate in the meeting. 


-no_force, —nfc 
does not add the link if the user is not eligible to participate in the meeting. (Default) 


-update, —ud . 
changes ali links to version 1 meetings into links to a version 2 meeting if that meeting 
exists in the directory that the link points to. For more information on version 1 and 
version 2 forum meetings, refer to “Duties of the Chairman” jater in this manual. 


LIST OF TRANSACTION SPEC/FICATION CONTROL ARGUMENTS: 

-after DT, -af DT 
selects transactions entered on or after the the date specified. The time of day is 
ignored. 


-after_time DT, -aft DT 
selects transactions entered after the date_time specified. 
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ee cee 


add_ meeting add_meeting 


-before DT, -be DT 
selects transactions entered before the date specified. The time of day is ignored. 


-before_time DT, —bet DT 
selects transactions entered before the date_time specified. 


-between DT1 DT2, -bt DT1 DT2 
selects transactions entered between the dates specified, inclusive. The times of day are 
ignored. 


-between_time DT1 DT2, -btt DT1 DT2 
selects transactions entered between the date_times specified, inclusive. 


-date DT, -dt DT 
selects transactions entered on the day specified. 


-from Person_id, -fm Person_id 
selects transactions entered by the participant named Person_id. 


-include_deleted, —id] 
prints or returns the index of the first unseen transaction in the meeting even if it is 
deleted. 


-only_deleted, -odlw 
prints or returns the index of the first deleted unseen transaction in the meeting. 


-only_non_deleted, -—ondl 
prints or returns the index of the first non_deleted unseen transaction in the meeting. 
(Default) 


-subject /tregexp/, -Sj /regexp/ 
selects transactions whose subjects match the given regular expression. 


—text /regexp/, -sj /tegexp/ 
selects transactions whose subjects match the given regular expression. 


NOTES 


If the directory >udd>Project>Person>meetings does not exist, and the -directory control 
argument is not given, a link with that name pointing to >udd>Project>Person is created in 
>udd>Project>Person. 
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add_participant : add_ project 


Name: add__participant, apt 

SYNTAX 

apt person_id {-control_args} 

FUNCTION 

makes the person identified by Person_id eligible to participate in the current meeting. You | 
can use this request if you have either modify permission on the containing directory or | 
chairman access to the meeting. 


ARGUMENTS 


person_id 
is the Person_id of the participant to be added. 


CONTROL ARGUMENTS 

-chairman, -cm 
gives chairman access (c) to the added participant. This control argument is not valid for | 
meetings created with pre-MR11 software. 


-read_oniy, —-To 
allows the added participant to read transactions but not to enter them. 


NOTES 


| 
The -read_only and -chairman control arguments cannot both be specified. For information | 
On converting a meeting, refer to “Duties of the Chairman" later in this manual. | 


Name: add__proiect, ani 

SYNTAX 

apj project_id {-control_args} 

FUNCTION 

Allows users from the project identified by project_id to become participants of the current 
meeting. You can use this request if you have either modify permission on the a | 
directory or chairman access to the meeting. 


ARGUMENTS 


project_id 
is the Project_id for the project to be admitted to the meeting. 
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add_ project announce_meeting 
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CONTROL ARGUMENTS 


-chairman, -cm 
gives chairman access (c) to the added project. This contro] argument is not valid 
for meetings created with pre-MR11 software. 


~-read_only, -ro 
allows users on the added project to read transactions but not to enter them. 


NOTES 


The -read_only and -chairman control arguments cannot both be specified. For 
information on converting a meeting, refer to “Duties of the Chairman" later in this 
manual. 


Name: announce_meeting, anm 
SYNTAX 

anm {-control_argument} 
FUNCTION 


places an announcement of the current meeting in another meeting. This announcement 
can be used with the add_meeting request by other users in order to add this meeting 
to their search list. 


CONTROL ARGUMENTS 


—enter_description, —eds 
prompts the user for a textual description of the meeting instead of using the 
text of the first transaction in the announcement. 


~meeting MEETING, -mtg MEETING 
specifies the name of the meeting where the announcement is to be placed. If 
~meeting is not given, the announcement is placed in the site’s default directory, 
normally >site>forum_dir>Meetings_Directory. 
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announcement_info announcement_info 


Name: announcement_info, ai 
SYNTAX 

ai {trans_spec} {-control_args} 
SYNTAX AS AN ACTIVE REQUEST 
[ai {trans_spec} -control_arg] 


FUNCTION 


Extracts information from a meeting announcement produced by the announce_meeting request. 


ARGUMENTS 


trans_spec 


is a transaction specifier designating the transaction containing the meeting announcement. 
An error occurs if this does not refer to a transaction entered by announce_meeting. See 


Section 3 for more information on transaction specifiers. Only one transaction 
selected. 


CONTROL ARGUMENTS 


-absolute_pathname, ~absp 
print or return the absolute pathname of the announced meeting. 


-chairman, -cm 
print or return the user_id of the chairman of the announced meeting. 


-entry_name, —etnm 
print or return the entry name of the announced meeting. 


LIST OF TRANSACTION SPECIFICATION CONTROL ARGUMENTS: 


-after DT, -af DT 


may be 


selects transactions entered on or after the the date specified. The time of day is 


ignored. 


-after_time DT, -aft DT 


selects transactions entered after the date_time specified. 


-before DT, -be DT 
selects transactions entered before the date specified. The time of day is ignored. 


-before_time DT, -bet DT 
selects transactions entered before the date_time specified. 


-between DT1 DT2, -bt DT1 DT2 


selects transactions entered between the dates specified, inclusive. The times of 
ignored. 
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announcement_info answer 


ime DTi DT2, -bit DTi DT2 
selects transactions entered between the date_times specified, inclusive. 


-date DT, -dt DT 
selects transactions entered on the day specified. 


-from Person_id, -fm Person_id 
selects transactions entered by the participant named Person_id. 


-subject /regexp/, -sj /Tegexp/ 
selects transactions whose subjects match the given regular expression. 


~text /regexp/, -tx /regexp/ 
selects transactions whose subjects match the given regular expression. 


Name: answer 

SYNTAX 

answer STR {-contrel_args} request_line 
FUNCTION 


provides preset answers to questions asked by another request 
ARGUMENTS 


STR 
is the desired answer to any question asked by request_line. If the answer is more than 
one word, it must be enclosed in quotes. If STR is —query, the question is passed on to 
the user. The ~-query control argument is the only one that can be used in place of 
STR. 


request_line 
is any Forum request line. It can contain any number of separate arguments (i.e., have 
spaces within it) and need not be enclosed in quotes. 

CONTROL ARGUMENTS 


~brief, —bf 
suppresses printing (on the user’s terminal) of both the question and the answer. 
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answer answer 


~call STR 
evaluates the active string STR to obtain the next answer in a sequence. The active string 
is constructed from Forum active requests and Multics active strings (using Forum’s 
"execute" active request). The outermost level of brackets must be omitted (ie: 
"forum_list -changed”) and the entire string must be enclosed in quotes if it contains 
Tequest processor special characters. The return value "true" is translated to “yes”, and 
"false" to "no". All other return values are passed as is. 


~exclude STR, -ex STR 
passes on, to the user or other handler, questions whose text matches STR. If STR 1s 
surrounded by slashes (/), it is interpreted as a gqedx regular expression. Otherwise, 
answer tests whether STR is literally contained in the text of the question. Multiple 
occurrences of -match and —exclude are allowed (see "Notes" below). They apply to the 
entire request line. 


-match STR 
answers only questions whose text matches STR. If STR is surrounded by slashes (/), it 
is interpreted as a gqgedx regular expression. Otherwise, answer tests whether STR is 
literally contained in the text of the question. Multiple occurrences of -match and 
-exclude are allowed (see "Notes" below). They apply to the entire request line. 


—query 
skips the next answer in a sequence, passing the question on to the user. The answer is 
tread from the user_i/o I/O switch. 


-then STR 
supplies the next answer in a sequence. 


-times N — 
gives the previous answer (STR, -then STR, or -—query) N times only (where N is an 
integer). 


NOTES 


Answer provides preset responses to questions by establishing a unit for the condition 
command_question and then executing the designated request line. If any request in the 
request line calls the command_query_ subroutine (described in the Subroutines manual) to ask 
a question, the on unit is invoked to supply the answer. The on unit is reverted when the 
answer request returns to Forum request level. See the Mu/tics Programmers’ Reference 
Manual, Order No. AG91 for a discussion of the command_question condition. 


If a question is asked that requires a yes or no answer and the preset answer is neither "yes" 
nor "no", the on unit is not invoked. 


The last answer specified is issued as many times as necessary, unless followed by the -times 
N control argument. 
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answer apply 


he -match and —-exclude control arguments are applied in the order specified. Each —match 
Causes a given question to be answered if it matches STR; each -exclude causes it to be 
passed on if it matches STR. A question that has been excluded by the -exclude control 
argument is reconsidered if it matches a ~-match later in the request line. For example, the 
request line: 


! answer yes -match /fortran/ -exclude /fortran_io/ -match /*“fortran_io/ 


answers questions containing the string "fortran", except that it does not answer questions 
containing "fortran_io". It does, however, answer questions beginning with "fortran_io”. 


Name: apply, ap 
SYNTAX 
ap {trans_specs} {-control_args} command_line 


FUNCTION 


places the text of the specified transaction into a temporary segment, appends the pathname 
of this segment to the end of command_line, and executes the resulting Multics command 
line. If an unprocessed transaction is specified, the transaction text is updated from the 
contents of the temporary segment after execution. 


ARGUMENTS 


trans_specs 
are transaction specifiers (see "List of transaction specification control arguments” below). 
If no trans_specs are given, the unprocessed transaction is selected. If there is no 
unprocessed transaction, one is created. See Section 3 for more information on 
transaction specifiers. 


command_line 
is any Multics command line. 


CONTROL ARGUMENTS 


~by_chain 
specifies that transactions are to be grouped by transaction chain. 


-fill, -fi 
specifies that the unprocessed transaction is to be refilled upon return from the 
command. This is the default unless the —no_input_fill contro] argument was given to the 
forum command or unless the —no_fill control argument was given to the talk or reply 
request. ; 
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apply apply 


-include_deleted, —idl 


processes transactions even if ed have been deleted. See "Notes" below. Default is 
~only_non_deleted. 


~initial 
processes only the transactions that are first in transaction chains. 
~no_fill, —-nfi 


specifies that the unprocessed transaction is not to be refilled upon return from the 
command. (Default) 


-only_deleted, —odl 
processes only deleted transactions. See "Notes" below. Default is -only_non_deleted. 


-oniy_non_deieted, —ondl 
processes only non-deleted transactions. (Defauit) 


—Teverse, -Iv 


causes transactions to be processed in the reverse order that they were given in the 
transaction specifier. 


LIST OF TRANSACTION SPECIFICATION CONTROL ARGUMENTS 


~after DT, -af DT 


selects transactions entered on or after the the date specified. The time of day is 
ignored. 


-after_time DT, -aft DT 
selects transactions entered after the date_time specified. 


~before DT, -—be DT 
selects transactions entered before the date specified. The time of day is ignored. 


-before_time DT, —bet DT 
selects transactions entered before the date_time specified. 


-between DT1 DT2, -bt DT1 DT2 
Selects transactions entered between the dates specified, inclusive. The times of day are 
ignored. 


~between_tim 1 DT2. -btt DT1 DT? 
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selects transactions entered between the date_times specified, inclusive. 


-date DT, -dt DT 
selects transactions entered on the day specified. 


-from Person_id, ~fm Person_id 
selects transactions entered by the participant named Person_id. 
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apply chairman 
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—subject /REGEXAP/, -sj /REGEXP/ 
selects transactions whose subject matches the given regular expression. 


—text /REGEXP/, -tx /REGEXP/ 
selects transactions whose text matches the given regular expression. 


NOTES 

The supplied command line need not be enclosed in quotes. However, if it contains 
parentheses, square brackets, semicolon, or quote characters they should be enclosed in quotes 
to prevent processing by Forum’s request processor. 

If more than one transaction is selected, the command line is applied to each selected 
transaction in turn. In order to select a deleted transaction, the user must either be the 
chairman of the meeting or the author of the deleted transaction. 


EXAMPLES 


This request can be used to edit the transaction with an editor other than qedx or ted. For 
example, the request: 


! apply emacs 


will invoke the emacs editor on the transaction. 


The request: 
! apply aref send_mai! Smith -sj Transactions -if 


will send each transaction in the current chain as mail to the user Smith. 


Name: chairman, cm 

SYNTAX 

cm {meeting} {-control_args} 
SYNTAX AS AN ACTIVE REQUEST 


[cm {meeting} ] 
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chairman check_meetings 


FUNCTION 


prints or returns the User_id (Person_id.Project_id) of the chairman of the specified meeting, 
or changes the chairman of the current meeting. If no arguments are given, the name of the 
chairman of the current meeting is printed. 


ARGUMENTS 


meeting 
is the name or pathname of a Forum meeting. 


CONTROL ARGUMENTS 


-force, -fc 
telis Forum not to ask if the chairman should be changed when using the -set control 
argumeni. 


—set new_chairman a3 
changes the chairman of the current meeting. mew_chairman must be of the form 
Person_id.Project_id. Only the current chairman is allowed to change the chairman. 


Name: check__meetings, ckm 

SYNTAX 

ckm {meeting_names} {-control_arg} 
FUNCTION 


establishes a list of meetings to be checked when changed. The user is notified when the 
meeting is changed. The meetings can be successfully viewed with the next_meeting (nm) 
request. 


ARGUMENTS 


meeting_names 


are names of meetings to be checked. The star convention is allowed. If meeting names 
re git en. the list of changed meetings will consist of any changed meetings in the list 
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given. If no meeting_names are given, information for all meetings found in the forum 


search path are printed. 
CONTROL ARGUMENTS 


-list, —Is 
prints the name of each changed meeting and the number of new transactions in each. 
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current_meeting 


SYNTAX 


emtg {-control_args} 


SYNTAX AS AN ACTIVE REQUEST 


[emtg {-control_args}] 


FUNCTION 


delete 


prints or returns the entry name or pathname of the meeting that the user is currently 


attending. 
CONTROL ARGUMENTS 


~-absolute_pathname, —absp 


prints or returns the full pathname of the meeting. 


-entry, et 


prints or returns only the entry name portion of the pathname of the current meeting. 


(Default) 


Name: delete, dl 
SYNTAX 
dl] trans_specs 


FUNCTION 


Allows participants to logically remove specified transactions from a meeting. The chairman 
of a meeting can delete any transaction, and a participant can delete any transaction that 
he/she submitted. These transactions can then be physically removed from the meeting by the 


chairman with the “expunge” request. 


ARGUMENTS 


trans_specs 


are transaction specifiers that determine which transactions are deleted (see below). See 
Section 3 for complete information on transaction specifiers. At least one transaction 


must be specified with this request. 


~] 
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delete delete 


LiST OF TRANSACTION SPECIFICATION CONTROL ARGUMENTS 


-after DT, -af DT 
selects transactions entered on or after the the date specified. The time of day is 
ignored. 


-after_time DT, -aft DT 
selects transactions entered after the date_time specified. 


-before DT, —be DT 
selects transactions entered before the date specified. The time of day is ignored. 


-before_time DT, —bet DT 
selects transactions entered before the date_time specified. 


-between DT1 DT2, -bt DT1 DT2 . 
selects transactions entered between the dates specified, inclusive. The times of day are 
ignored. 


-between_time DT1 DT2, -btt DT1 DT2 
selects transactions entered between the date_times specified, inclusive. 


-date DT, -dt DT 
selects transactions entered on the day specified. 


-from Person_id, -fm Person_id | 
selects transactions entered by the participant named Person_id. 


-subject /REGEXP/, -sj /REGEXP/ 
Selects transactions whose subject matches the given regular expression. 


-text /REGEXP/, -tx /REGEXP/ 
selects transactions whose text matches the given regular expression. 


NOTES 


Deleted transactions are ignored by all requests that process transactions. Deleted transactions 
can be restored by using the "retrieve" request. 
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delete_participant do 


Name: delete__participant, dipt 
SYNTAX 

dipt Person_ids {-control_args} 
FUNCTION 


logically removes the record of participation (attendee record) of a participant in a meeting. 
Once removed, these attendee records can be deleted with the "expunge" request. Only the 
chairman of the meeting can issue either request. 

ARGUMENTS 


Person_ids 
are the name(s) of the participants whose records are to be deleted. 


CONTROL ARGUMENTS 


-brief, —bf 
suppresses the message "Specified switch was not changed." 

-long, —lg 
prints the message "Specified switch was not changed.” if the record for that participant 
has already been deleted. (Default) 


NOTES 


Deleted participants are ignored by all requests that list participants. Deleted participants can 
be restored by using the “retrieve_participant” request. 


Name: do 
SYNTAX 


do request_string {args} 
or: do -control_args 


SYNTAX AS AN ACTIVE REQUEST 
[do "request_string" args] 
FUNCTION 


expands a request line by substituting the supplied arguments into the line before execution. 
AS an active request, returns the expanded request_string rather than executing it. 


~3 
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do do 


ARGUMENTS 


request_string 
is a Forum request line enclosed in quotes. 


args 
are character string arguments that replace parameters in request_string. 


CONTROL ARGUMENTS 
These control arguments set the mode of operation of the do request: 


—absentee 
establishes an any_other handler that catches all conditions and aborts execution of the 
Tequest line without aborting the process. 


~brief, —bf 
does not print the expanded request line before execution. (Default) 


passes on the expanded request line for execution. (Default) 


—interactive 
does not establish the any_other handier. (Defauit) 


-long, —ig 
prints the expanded request line before execution. 


—nogo 
does not pass on the expanded request line for execution. 


LIST OF PARAMETERS 

Any sequence beginning with & in the request line is expanded by the do request using the 
arguments given on the request line. 

&1l ... &9 are replaced by the first through 9th arguments respectively. 

&(N) is replaced by argN where N is any integer. 

&ql ... &q9 is replaced by the first through 9th arguments with any quotes doubled. 

&a(N) is replaced by argN with any quotes doubled. N can be any integer. 


&rfl ... &rf9 is replaced by the first through 9th arguments surrounded by a level of quotes 
with any contained quotes doubled. 


&r(N) is replaced by a requoted argN. I can be any integer. 
&IN is replaced by all the arguments starting with argN where N must be a digit 


from 1 te 9. 
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do enter 


&f(N) is replaced by all the arguments starting with argN where N can be any 
integer. 

&aqfN is replaced by all the arguments starting with argN with any quotes doubled. N 
must be a digit from 1 to 9. 

&af(N) is replaced by all the arguments starting with argN with quotes doubled where 
N can be any integer. 

&rN is replaced by all the arguments starting with argN. Each argument is placed 
in a level of quotes with contained quotes doubled. N must be a digit from 1 
to 9. 

&rf(N) is replaced by all the arguments starting with argN, requoted. N can be any 
value. 

&E is replaced by an ampersand. 

&! is replaced by a 15 character unique string. The string used is the same 
everywhere & appears in the request line. 

&n is replaced by the actual number of arguments supplied. 

&f&n is replaced by the last argument supplied. 


Name: enter, en, send 
SYNTAX 

en {-control_args} 
FUNCTION 


enters an unprocessed transaction, that was created either by escaping to the Forum request 
loop via "talk" mode or by using the "qedx" or "ted" requests. 


CONTROL ARGUMENTS 


-brief, —bf 
suppresses the message indicating the transaction was entered. 


-long, —lg 
prints a message indicating that the transaction was successfully entered. (Default) 
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enter exec_com 


-meeting meeting_name, -mig meeting_name 
enters the transaction into the proceedings of the meeting _name meeting. The default is 
to enter the transaction into the meeting that the user was attending when the transaction 
was created. Meeting name can be the name or pathname of a meeting. This control 
argument cannot be used if the transaction was built using the "reply" request. 


Name: exec_com, ec 

SYNTAX 

ec ec_path {ec_args} 

SYNTAX AS AN ACTIVE REQUEST 
[ec ec_path {ec_args}] 
FUNCTION 


executes a exec_com segment containing forum requests. As an active request, it returns a 
value passed from the exec_com segment with the &return statement. 


ARGUMENTS 


ec_paths 
is the pathname of an exec_com program. The "fmec" suffix is assumed if not 
specified. 


ec_args 
are optional arguments to the exec_com program and are substituted for parameter 
references in the program. 


NOTES 


Forum searches the "exec_com" search list for ec_paths with the ".fmec" suffix unless an 
absolute pathname is given. 


For a description of the exec_com language (both version 1 and version 2), see the 
Commands manual. 


When evaluating a subsystem exec_com program, Forum active requests are used rather than 
Multics active functions when evaluating the &[...] construct and the active string in an &if 
statement. The subsystem’s execute active request must be used to evaluate Multics active 
strings within the exec_com. 
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execute expunge 


Name: execute, e 
SYNTAX 


e LINE 

SYNTAX AS AN ACTIVE REQUEST 
[e LINE] 

FUNCTION 


executes the supplied line as a Multics command line. As an active request, evaluates a 
Multics active string and returns the result to the Forum request processor. 


ARGUMENTS 


LINE 
is the Multics command line to be executed or the Multics active string to be evaluated. 
It need not be enclosed in quotes. 


NOTES 


The recommended method to execute a Multics command line from within Forum is the ".” 
escape sequence which does not expand Forum active requests in the line before passing it to 
the command processor. The "execute" request is intended as a means of passing information 
from Forum to the Multics command processor. 


All unquoted (), [], and " characters in the given line are processed by the Forum request 
processor and not the Multics command processor. This fact permits the passing of the values 
of Forum active requests to Multics commands when using the "execute" request or, when 
using the "execute" active request, to Multics active functions for further manipulation before 
Teturning the values to the Forum request processor for use within a request line. 


Name: expunge 

SYNTAX 

expunge {-control_args} 

FUNCTION 

physically removes deleted participant records and transactions from a meeting and frees their 
storage. This request also checks the consistency of the control segment and attempts to 


salvage invalid transaction and attendee records (see "Notes" below). Only the chairman of the 
meeting can issue this request. 
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expunge ~ fill 


CONTROL ARGUMENTS 


-brief, —bf 
suppresses the messages indicating how many participants and transactions were expunged. 


~force, -fc 
does not ask if the user really wants to expunge the meeting. 


-long, -lg 


prints messages indicating how many participants and transactions were expunged. 
(Default) 


—participants, —part 
expunges only attendee records. The default expunges both attendee records and 
transactions. 


—transactions, ~trans 
expunges only transactions. The default expunges both attendee records and transactions. 


NOTES 
A user’s attendee record is his record of participation in the meeting, which displays his 


User_id, last time attended, and last transaction seen. Attendee records are printed by the 
“list_users" request. 


Name: fill, fi 
SYNTAX 

fi {-control_args} 
FUNCTION 


teformats the text of the unprocessed transaction to fit within a given line length. It is also 
used to control whether or not the transaction is filled after it is entered. 


CONTROL ARGUMENTS 


-line_iength N, -li N 
is the width to be used when reformatting the text. (Default-- either the value specified 
by the -line_length argument to the forum command or 72 if this argument was not 
given). The line length given must be between 10 and 136. 


-off 
does not fill this transaction by default when printed or written. 


fills this transaction by default when printed or written. 
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forum_dir goto 


SYNTAX AS AN ACTIVE REQUEST 
[fd] 
FUNCTION 


prints/returns the absolute pathname of the central forum directory. 
NOTES 


The central forum directory is the location for site-approved public meetings. This directory 
is included in the default forum search path. The forum request: ; 


! e add_search_paths forum [forum_dir] 


can be used to add the central directory to the forum search path. See Section 3 for more 
information on search paths. 


Name: goto, go, g 

SYNTAX 

g {meeting name} {-control_arg} 
FUNCTION 


enters a meeting or switches from one meeting to another. This request requires access to the 
meeting_name meeting. 


ARGUMENTS 


meeting_name 
is the pathname or entryname of an established meeting. If a pathname is specified, it 
identifies the meeting directly. Otherwise, the forum search list will be used in an 
attempt to locate the meeting. The ".control"” suffix is optional. Either this argument or 
the "-meeting” control argument must be given. 


CONTROL ARGUMENTS 
—meeting meeting_name, -mtg meeting_name 


enters the meeting whose pathname or entryname is meeting_name. See the description of 
the meeting_name argument above. 
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goto help 


“no_feturn_on_efror, -nroe 
does not return to the current meeting if meeting_name does not exist or cannot be 
accessed for any other reason (this is the default). 


~return_on_error, —Toe 
teturns to the current meeting if the new meeting cannot be accessed. 


Name: heip 

SYNTAX 

help {topics} {-control_args} 
FUNCTION 


prints information about various Forum topics including detailed descriptions of Forum 
requests. 


ARGUMENTS 


topics 
are the topics on which information is to be printed. The topics available within Forum 
can be determined by using the “list_help” request (see “list_help" below). 


CONTROL ARGUMENTS 
The following specify information selection. All but -all and —brief leave you in help’ s 
Tequest loop after they have printed their specific information. 


-all, -a 
prints the entire info without intervening questions. 


-brief, —bf 
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—brief_header, -bfhe 
prints a brief heading with the info. 


~-control_arg STR, -ca STR 
prints the descriptions of control (or other) arguments containing the string STR. 


-header, —he 
prints only the heading line. 


-search STRs, -srh STRs 


begins printing with the paragraph containing all the strings STRs. By default, printing 
. begins at the top of the information. 
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help help 


-<eartinn STRe vern CTR. 
Wee LIL wk drwy wwii je Se eI 


begins printing at the section whose title contains all the strings STRs. By default, 
printing begins at the top of the information. 


title 
prints section titles and section line counts, then asks if the user wants to see the first 
paragraph of information. 


LIST OF RESPONSES 


? 
prints the list of responses allowed to help queries. 


identifies the current Forum environment. 


.. Command_line 
treats the remainder of the response as a Multics command line. 


brief, bf 
prints a brief summary, including the Syntax section and a list of arguments, then repeats 
_the previous question. 


control_arg STR, ca STR 
prints the descriptions of control (or other) arguments whose names contain STR. 


header, he 
prints a long heading line consisting of the pathname of the info seg, heading, and line 
count 


no, 0 
stops printing information for this topic and proceeds to the next topic, if any. 


quit, q 
stops printing information for this topic and returns to the Forum’s request level. 


rest {-scn}, r {-scn} 
prints remaining information for this topic without intervening questions. If -section or 
—stn is given, “help” prints only the rest of the current section without questions and 
then asks if the user wants to see the next section. 


search {STRs} {-top}, srh {STRs} {-top} 
skips to the next paragraph containing all the strings STRs. If -top or -t is given, 
searching starts at top of the information. If STRs are omitted, “help” uses the STRs 
from the previous search response or the -search control argument. : 


section {STRs} {-top}, scn {STRs} {-top} 
skips to the next section whose title contains all the strings STRs. If -top or -t is 
given, title searching starts at the top of the information. If STRs are omitted, “help” 
uses the STRs from the previous section response or the —section control argument. 


mon Area AN 
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help if 


skip {-scn|-seen}, s {-scn|-seen} 
skips to the next paragraph. If -section or -scn is given, skips all paragraphs of the 
current section. If -seen is given, skips to the next paragraph that the user has not seen. 
Only one control argument is allowed in each skip response. 


title {-top} 
lists titles and line counts of the sections that follow; if -top or -t is given, “help” lists 
all section titles. “help” then repeats the previous question after titles are printed. 

top, t 


skips to the beginning of the info seg, prints the heading line, and asks whether the user 
wants to see the first section. 


yes, y 
prints the next paragraph of information on this tonic. 


NOTES 
If given no topic names, the “help" request explains what requests are available to obtain 


information about Forum. 


For a more complete description of the control arguments and responses accepted by this 
Tequest, see the help command in the Commands manual. 


Name: if 
SYNTAX 
if EXPR -then LINE] {-else LINE2} 
SYNTAX AS AN ACTIVE REQUEST 
[if EXPR -then STR1 {-else STR2}] 
FUNCTION 
conditionally executes one of two request lines depending on the value of an active string. As 
an active request, returns one of two character strings to the Forum request processor 
depending on the value of an active string. 
ARGUMENTS 
EXPR 
is the active string that must evaluate to either "true" or "false". The active string is 


constructed from Forum active requests and Multics active strings (using the Forum’s 
execute active request). 
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if list 


LINE1 
is the Forum request iine to execute if EXPR evaluates to "true". If the request line 
contains any request processor characters, it must be enclosed in quotes. 


STR1 
is returned as the value of the if active request if the EXPR evaluates to “true”. 


LINE2 
is the Forum request line to execute if EXPR evaluates to "false". If omitted and EXPR 
is "false", no additional request line is executed. If the request line contains any request 
processor characters, it must be enclosed in quotes. 


STR2 
is returned as the value of the if active request if the EXPR evaluates to "false". If 
omitted and the EXPR is “false”, a null string is returned. 


Name: list, Is 

SYNTAX 

Is {trans specs} {-control_args} 
SYNTAX AS AN ACTIVE REQUEST 
[ls {trans_specs} {-control_args}] 
FUNCTION 


prints the transaction number, author, subject, and date/time of specified transactions on the 
user’s terminal. As an active request, returns a list of numbers of selected transactions. 


ARGUMENTS 


trans_specs 
are transaction specifiers that determine the transactions to be listed. See “List of 
transaction specification control arguments” below. See Section 3 for complete information 
on transaction specifiers. If no transaction specifiers are supplied, all transactions are 
listed. 


CONTROL ARGUMENTS 


brief, —bf 
prints a brief summary line for each transaction selected. 


~by_chain 
specifies that transactions are to be grouped by transaction chain. 
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list list 


-fill, -fi 
fills listed transactions in order to obtain the line count. Not valid if invoked as an 
active request. 


~header, —he 
prints the header. (Default) 


-include_deleted, —id] 
lists transactions even if they have been deleted. See "Notes" below. Default is 
~only_non_deleted. 


~inhibit_error, —ihe 
does not print an error if no transactions are selected. Only valid if invoked as an 
active request. 


—initial 
lists only the transactions that are at the beginning of transaction chains. 


-long, -lg 
prints a complete summary of the transaction. (Default) 


-long_subject, —lgsj 
inhibits truncation of summary lines. The subject of the transaction will extend to the 
next line if it is longer than the terminal width. 


~meeting meeting_name, ~mtg meeting_name 
selects the specified transactions from the meeting_name meeting. The default selects 
transactions from the current meeting. 


-no_fill, -nfi 
suppresses filling of transactions in order to obtain the line count. Not valid if invoked 
as an active request. (Default) 


-no_header, -nhe 
suppresses printing of the header. Not valid if invoked as an active request. 


-no_inhibit_error, —nihe 
prints an error if no transactions are selected. Only valid if invoked as an active 
request. (Default) 


—no_update, -nud 
causes the list request to not update the current transaction index. Not valid if invoked 
aS an active request. 


-only_deleted, —od] 
lists only deleted transactions. See "Notes" below. Default is -only_non_deleted. 


~only_non_deleted, -ondl 
lists only non-deleted transactions. (Default) 
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list list 


-output_file PATH, -of PATH 
directs the output of the list request to the file named by PATH. Not valid if invoked 
as an active request. 


~Teverse, —TV 
lists transactions in the reverse order of that specified. 


-update, —ud 
sets the current transaction index to the index of the first transaction listed unless the 
current transaction is among those listed. Not valid if invoked as active request. 
(Default) 


LIST OF TRANSACTION SPECIFICATION CONTROL ARGUMENTS 


-after DT, -af DT 
selects transactions entered on or after the the date specified. The time of day is 
ignored. 


~after_time DT, -aft DT 
selects transactions entered after the date_time specified. 


-before DT, -be DT 
selects transactions entered before the date specified. The time of day is ignored. 


~before_time DT, -bet DT 
selects transactions entered before the date_time specified. 


-between DT1 DT2, -bt DT1 DT2 
selects transactions entered between the dates specified, inclusive. The times of day are 
ignored. 


~-between_time DT1 DT2, -btt DT1 DT2 
selects transactions entered between the date_times specified, inclusive. 


-date DT, -dt DT 
selects transactions entered on the day specified. 


-from Person_id, -fm Person_id 
selects transactions entered by the participant named Person_id. 


-subject /REGEXP/, -sj} /REGEXP/ 
selects transactions whose subject matches the given regular expression... 


-text /REGEXP/, -tx /REGEXP/ 
selects transactions whose text matches the given regular expression. 


NOTES 


In order to list a deleted transaction, the user must either be the chairman of the meeting or 
the author of the deleted transaction. 
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list_help list_meetings 


Name: list_help, ih 
SYNTAX 
Ih {topics} 
FUNCTION 
displays the names of all Forum info (help) segments pertaining to a given set of topics. 
ARGUMENTS 
topics 
specifies the topics of interest. Any Forum info segment that contains one of these 
topics is listed. 
NOTES 
If no topics are given, all info segments available for Forum are listed. 
When matching topics with info segment names, an info segment name is considered to match 
a topic only if that topic is at the beginning or end of a word within the segment name. 
Words in info segment names are bounded by the beginning and end of the segment name 
and by the characters period (.), hyphen (-), underscore (_), and dollar sign ($). The ".info" 
suffix is not considered when matching topics. 
EXAMPLES 


! lJist_help ex 


matches info segments named expunge, execute, trans_specs_ex, and exec_com but does not 
match an info segment named nextref. 


Name: list_meetings, Ism 

SYNTAX 

Ism {meeting_names} {-control_args} 
SYNTAX AS AN ACTIVE REQUEST 
[1sm {-control_args}] 

FUNCTION 


prints a list of selected meetings on the user’s terminal. For each meeting selected, 
information about the names of the meeting and per-user meeting attributes are listed. 
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list_ meetings list_meetings 


ARGUMENTS 


meeting_names 
are optional meeting_names. If any are supplied, information about only the specified 
meeting_names is printed. The star convention is supported for meeting_names. If no 
meeting names are given, information for all meetings found in the forum search path 
are printed. 


CONTROL ARGUMENTS 


-absolute_pathname, —absp 
prints the absolute pathname of a meeting. The defauit lists the iong and short meeting 
names only. 


-adjourned, —adj 
selects information about meetings that have been adjourned. 


-all, -a 
prints information about all meetings. The default prints information about the meetings 
in which the user is eligible to participate only. 


-brief, —bf 
suppresses the message "No meetings have changed", which is printed by default if the 
~changes control argument is used and no meetings have changed. 


-chairman {Person_id}, -cm {Person_id} 
prints information about meetings of which Person_id is chairman. If Person_id is not 
given, the user’s Person_id is used. 


—changed, —chg 
prints information about meetings in which the user is a participant and in which new 
transactions have been entered. 


count, -ct 
prints out the number of new transactions for a meeting in which the user is 
participating. This control argument cannot be used if list_meetings is invoked as an 
active request. 


-eligible, —elig 
prints information about all meetings in which the user is eligible to participate. 
(Default) 


-exclude meeting_names, —ex meeting_names 
excludes the meetings identified by meeting_names from the output list. The meeting_names 
argument can be a starname. The default (-include) is to select all meetings that. match 
the specified starname. 


-from DT, -fm DT 


selects meetings that have changed since the specified time. DT is any string acceptable 
to the convert_date_to_binary_ subroutine. The default is the current date-time. 
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list_meetings list_ meetings 


-header, —he 
prints the header. This is the default, unless the -changes control argument is given. 


—include meeting_names, -incl meeting_names 
includes the meetings identified by meeting_names in the output list. The meeting_names 
argument can be a starname. (Default) 


-inhibit_error, —ihe 
does not print warning messages for such things as bad meeting format and errors 
encountered while searching for meetings. (Default) 


-long, —lg 
prints the message "No meetings have changed" if the ~changes control argument is used 
and no meetings in which the user is a participant have changed. (Default) 


—no_adjourned, —nadj 
specifies that adjourned meetings are not to be listed. 


~no_changes, —nchg 
does not list changed meetings. 


-no_header, -nhe 
suppresses printing of the header. 


—no_inhibit_error, —nihe 
prints aii warning messages. 


—no_notify, -nnt 
does not list meetings in which the user has the notify flag set. 


—no_participating, —npart 
does not list meetings in which the user is a participant. 


-no_read_only, -nro 
does not list meetings to which the user has onlv re 


—notify, -nt 
lists only meetings in which the user has the notify flag set. 


—participating, —part 
lists only meetings in which the user is participating. The default prints information 
about all meetings in which the user is eligible to participate. 


-read_only, -ro 
lists just meetings to which the user has only read access. 


-user User_id 
determines participation, changes, and eligibility attributes for the user specfied by 
User_id. User_id is in the form Person_id.Project_id.tag, where any of the components 
can be the character "*". If a component is omitted, it is assumed to be "#", 
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list_meetings list_requests 


prints the chairman’s User_id and current and last transactions for each meeting. Cannot 
be used with -changes or when Ism is being invoked as an active request. 


NOTES ON FLAGS 


The output from this command can include flags that have the following interpretation: 


a attending flag: Indicates that the user is currently attending the meeting. 

e eligible flag: indicates that the user can participate in the meeting. 

p participant flag: indicates that the user is a participant in the meeting (ie., has 
“gone to” the meeting at least once). 

T removed flag: indicates that the user has removed himself from participation in 
the meeting. 

n notify flag: indicates that the user has turned on the notify flag in the 


meeting (i.e, that the user has requested online notification when new 
transactions are entered in the meeting). 


Cc change flag: indicates that mew transactions have been entered in the 
proceedings of the meeting since the user last attended this meeting. 

oO observer flag: indicates that the user has only read access to the meeting. 

j adjourned flag: indicates that the chairman has temporarily adjourned the 
meeting. 


Note that the flags corresponding to the selection criteria are not shown {ie., if the user is 
selecting meetings to which he or she is eligible, the "e" flag is not printed). 


Name: list__requests, ir 
SYNTAX 

Ir {STRs} {-control_args} 
FUNCTION 


prints a brief description of selected Forum requests. 
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list_requests list_users 


ARGUMENTS 

STRs 
specifies the requests to be listed. Any request with a name containing one of these 
strings is listed unless -exact is used, in which case the request name must exactly match 
one of these strings. 

CONTROL ARGUMENTS 

~all, -a 
includes undocumented and unimplemented requests in the list of requests eligible for 
matching the STR arguments. 


exact 


lists only those requests whose names exactly match one of the STR arguments. 
NOTES 
If no STRs are given, all requests are listed. 
When matching STRs with request names, a request name is considered to match a STR only 
if that STR is at the beginning or end of a word within the request name. Words in request 
names are bounded by the beginning and end of the request name and by the characters 
period (.), hyphen (-), underscore (_), and dollar sign ($). 
EXAMPLES 

! list _requests ex. 

matches requests named execute and exec_com but does not match a request named nextref. 


You have to specify —all to get the expunge request listed, unless you are the chairman of 
the meeting you are currently attending. 


Name: list__users, Isu 

SYNTAX 

Isu {-control_args} 

SYNTAX AS AN ACT/VE REQUEST 

[lsu {-control_args}] 

FUNCTION 

prints a list of selected participants of a meeting. For each participant selected, the 


Person_id, Projecit_id, current transaction number (last one seen), the date/time last attended, 
and several flags are listed. The active request returns a list of Person_ids. 
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CONTROL ARGUMENTS 


-after TIME, -af TIME 
lists only those participants who have attended since the given time. 


-all, -a 
lists all participants, including those who are not participating in the meeting. 


-ascending, -asc 
sort in ascending order. This is the default for sorting by name. This may not be used 
if invoked as an active request. 


~attending, —at 
lists only participants who are currently attending this meeting. 


-before TIME, -be TIME 
lists only those participants who have not attended since the given time. 


-brief, —bf 
suppresses the message "No participants were selected.” 


~descending, —dsc 
sort in descending order. This is the default for sorting by time last attended. This 
control argument cannot be used if list_users is invoked as an active request. 


-eligible, —elig 
prints a list of users and projects that are eligible to attend the meeting. Read-only 
eligibility is denoted by an asterisk (*). This control argument cannot be used if 
list_users is invoked as an active request. This control argument cannot be combined with 
any other control argument. 


~header, —he 
prints the header. This control argument cannot be used if list_users is invoked as an 
active request. (Default) 


-long, —lg 
prints the message "No participants were selected." if this is the case. (Default) 


—meeting meeting_name, -mtg meeting_name 
lists participants of the meeting_name meeting. The default lists participants of the 
current meeting. 


—names_only 
only prints the names of the selected participants. This control argument is not valid if 
names_only is invoked as an active request. 


-no_header, —nhe 
suppresses printing of the name_list header. 


—no_participating, —npart 
lists only those users who are no longer participating. 
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-no_read_only, -nro 
does not list read-only participants. 


-notify, —nt 
lists only participants who have the notify flag set. 


~only_deleted, -odl 
lists only information for participants who have been deleted by the chairman. 


~only_non_deleted, —ondl 


lists only information for participants who have not been deleted by the chairman. 
(Default) 


-participating, —part 
lists only users who are participating. (Default) 


-project Project_ids, —pj Project_ids 
lists only information about participants on the specified project. All arguments following 
—project until the next control argument are taken as Project_ids. 


~read_only, -ro 
lists just the read-only participants. 


~—seen transaction_number 
lists only the participants who have read the specified transaction. 


-sort TYPE 
sorts the output by TYPE. TYPE is either “name” for Sorting by the Person_id of 
participants, or "date _time_attended" (dta) for sorting by the time the participant last 
attended the meeting. This control argument cannot be used if list_users is invoked as an 
active request. 


-totais, -tt : 
prints only the total number of participants selected. 


—unseen transaction_number 
lists only participants who have not read the specified transaction. 


—-user Person_ids 


lists only information about the named participants. All arguments following -user until 
the next contro] argument are taken as Person_ids. 


NOTES 


The displayed flags have the following meanings: "d" indicates that the chairman has deleted 
that participant, "r" indicates that the participant has been removed from the meeting and is 
therefore no longer a participant, "n" means that the user has the “notify flag" turned on, 
and "o" means. that the user is an observer and cannot enter transactions. 
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mail mail 


Name: mail 

SYNTAX 

mail {trans specs} {-control_args} 
FUNCTION 


sends a transaction or set of transactions to other users, mailing lists, or Forum meetings 
using the Multics mail system. 


ARGUMENTS 


trans_specs 
are transaction specifiers which determine the transactions to be mailed. See Section 3 
for more information on transaction specifiers. If no transaction specifiers are supplied, 
the unprocessed transaction is mailed if there is one, otherwise the current transaction is 
mailed. If more than one transaction is specified, each one is sent as a separate piece of 
mail. 


CONTROL ARGUMENTS 


~acknowledge, —ack 
requests an acknowledging message from the recipients when they read the mail. 


—bec addresses 
specifies recipients who will receive blind carbon copies of the mail. Either -bcec 
addresses, -cc addresses, or —to addresses is required. 


-brief, —bf 
suppresses messages informing the user of successful mail delivery. 


—cce addresses 
specifies recipients who will receive carbon copies of the mail. Either -—bcc addresses, —cc 
addresses, or -to addresses is required. 


-fill, -fi 
specifies that the transactions should be filled before being mailed. 


~line_length LEN, -i] LEN 
specifies the line length to be used for filling. If this control argument is given, -fill 
need not be. 


~long, —lg 
prints messages informing the user of successful mail delivery. (Default) 


~no_acknowledge, —nack 
does not request acknowledging messages from the recipients. (Default) 


-no_fill, -nfi 
does not fill the transactions before mailing them. (Default) 
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-teply_to addresses 
specifies the return address which will appear in the Reply-To field of the mail. Either 
-bec addresses, -cc addresses, or -to addresses is required. 


-subject STR, -sj STR . 
sets the subject of the mail to be STR. The default subject is the subject of the 
transaction being mailed. 


-to addresses 
specifies the primary recipients of the mail. This control argument is required. 


NOTES 


The mail contains two header fields identifying it as having been sent by forum. These fields 
are: 


Forum-Transaction: [NNNN] in the MEETING PATH meeting. 


Transaction-Entered-By: AUTHOR 
Transaction-Entered-Date: DATE_TIME 


See the Mul/tics Extended Mail System User’s Guide, Order No. CH23, for information on 
the valid syntax for mail addresses. 


Name: make__public, mp 
SYNTAX 

mp {-control_args} 
FUNCTION 


opens the current meeting to public participation. You can use this request if you have either 
modify permission on the containing directory or chairman access to the meeting. 


CONTROL ARGUMENTS 

~chairman, -cm 
gives access {c) to the added participant. This control argument is not valid for meetings 
created with pre-MR11 software. 


-Ttead_only, -ro 
allows the public to read transactions but not to enter them. 


NOTES 


The -read_only and -chairman control arguments cannot both be specified. For information 
on converting a meeting, refer to "Duties of the Chairman” later in this manual. 
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next_meeting next_meeting 


Name: next_meeting, nm 

SYNTAX 

nm {-control_arg} 

SYNTAX AS AN ACTIVE REQUEST 
(nm {-control_arg}] 

FUNCTION 


changes the current meeting to the next meeting in the list of changed meetings established 
by the check_meetings request. As an active function, it returns the name of the next 
meeting on the list. In either case, that meeting is removed from the list. 


CONTROL ARGUMENTS 


~all, ~a 
prints or returns a list of all of the meetings in the list of changed meetings, including 
those already checked by this request. If this control argument is used, neither the 
current meeting nor the list will be changed. 


-list, -ls 
prints or returns a list of the remaining meetings in the list of changed meetings. If this 
control argument is used, neither the current meeting nor the list will be changed. 


NOTES 


The check_meetings request must have already been used in this process. This request calls 
the request processor with the request line: 


goto MEETING NAME 
so a user-defined abbreviation for the goto request will be expanded. 


When -all or -list is used, the count of new transactions displayed is the number of 
transactions that were new when the check_meetings request was invoked. 
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Name: print, pr, p 

SYNTAX 

p itrans_specs} {-control_args} | 
FUNCTION 


prints specified transactions on the terminal. 


ARGUMENTS 


trans_specs 
are transaction specifiers that determine the transactions to be printed. See “List of 
transaction specification control arguments” below. See Section 3 for complete information 
on transaction specifiers. If no transaction specifiers are supplied, the unprocessed 
transaction is printed (if there is one), otherwise the current transaction is printed. 


CONTROL ARGUMENTS 

-by_chain 
specifies that transactions are to be grouped by transaction chain. 

-fill, —-fi 
fills transactions before printing them. 

-include_deleted, —idi . 
selects transactions even if they have been deleted. See "Notes" below. Default is 
-only_non_deleted. 

initial 
selects only transactions that begin transaction chains. 

—meeting meeting name, -—mtg meeting_name 


selects the specified transactions from the meeting_name meeting. The default selects 
transactions from the current meeting. 


-no_fill, -nfi 
suppresses filling of transactions. (Default) 


-only_deleted, —odi 
selects only deleted transactions. See "Notes" below. Default is -only_non_deleted. 


-only_non_deleted, -ond] 
selects only non-deleted transactions. (Default) 


-reverse, -Irv 
prints transactions in the reverse order of that given in the transaction specifier. 
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LIST OF TRANSACTION SPECIFICATION CONTROL ARGUMENTS 


~after DT, -af DT 
selects transactions entered on or after the date specified. The time of day is ignored. 


-after_time DT, -aft DT 
selects transactions entered after the date_time specified. 


-before DT, -be DT 
selects transactions entered before the date specified. The time of day is ignored. 


~-before_time DT, -bet DT 
selects transactions entered before the date_time specified. 


-between DT1 DT2, -bt DT1 DT2 . 
selects transactions entered between the dates specified, inclusive. The times of day are 
ignored. 


—-between_time DT1 DT2, -btt DT1 DT2 
selects transactions entered between the date_times specified, inclusive. 


-date DT, -dt DT 
selects transactions entered on the day specified. 


-from Person_id, -fm Person_id 
selects transactions entered by the participant named Person_id. 


~line_length LENGTH, -il LENGTH 
| fills the transaction to the specified line length. The default is 72 columns unless a 
different value was given with the -output_line_length or -line_length control argument 
to the forum command. 


-subject /REGEXP/, -sj /REGEXP/ 
selects transactions whose subject matches the given regular expression. 


—text /REGEXP/, -tx /REGEXP/ 
selects transactions whose text matches the given regular expression. 


NOTES 


In order to print a deleted transaction, the user must be either the chairman of the meeting 
or the author of the deleted transaction. 
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Name: gedx, qx 
SYNTAX 

qx {-control_arg} 
FUNCTION 


invokes the Qedx editor to edit the text of the unprocessed transaction or to build a new 
transaction. See the Qedx Text Editor User's Guide, Order No. CG40, for more 
information on the Qedx editor. 


CONTROL ARGUMENTS 


—auto_write 
specifies that the “w” request is not required in order to save editing changes. See 
“Notes”. 


-fill, -fi 
specifies that the transaction is to be refilled upon exit from the editor. This is the 
default unless the -no_input_fill contro] argument was given to the forum command or 
unless the -no_fill control argument was given to the talk or reply request. 

no_auto_write 


"specif ies that the "w" request is required in order to save editing changes. (Default) 


-no_fill, —nfi 
specifies that the transaction is not to be refilled upon exit from the editor. (Default) 


NOTES 


The transaction text is placed in a buffer . The write (w) request must be used to save any 
changes unless -auto_write is given. If -auto_write is given, the contents of the buffer always 
replaces the transaction when the editor is exited. The write request can be used as often as 
desired to checkpoint the editing process. 


If the quit (q) request is issued, -auto_write was not specified, and the transaction has been 
modified since it was last written, qedx will query for permission to exit. If permission is 
given, any changes made since the last write request (if any) will be lost. The quit-force (qf) 
Tequest can be used to abort unwanted editing without being queried. 


The read (r) and write (w) requests still accept pathnames and may be used to insert a 
segment into the transaction or make a copy in a segment for later use, respectively. 
However, when used with a pathname, these requests will not change the default pathname 
for the buffer (the transaction). Using either read or write without a pathname will always 
refer to forum’s copy of the transaction. 
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qedx remove_meeting, 
if issued before use of the write request, the request line: 


! 1,$dr 


will restore the original transaction text to the buffer. If given after a write request, this 
request line will restore the transaction as saved by the last write request given in the buffer. 


For information on converting a meeting, refer to “Duties of the Chairman” later in this 
manual. 


Name: quit, q 

SYNTAX 

q {-control_arg} 
FUNCTION 

exits the Forum subsystem. 
CONTROL ARGUMENTS 


-force, -fc 
does not ask if the user really wants to quit if there is an unprocessed transaction. 


Name: remove _meecting, rm 

SYNTAX 

rm {meeting names} {-contro]_args} 
FUNCTION | 


removes meetings in the user’s forum search list by deleting links to them from the directory 
>udd>Project>Person>meetings. 


ARGUMENTS 
meeting _ names 


are names of forum meetings to be removed from the search list. The star convention is 
allowed. 
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remove_meeting, remove_ participant 


CONTROL ARGUMENTS 


-check, -ck 
lists all links to meeting in >udd>Project>Person>meetings that point to non-existent 
meetings. Incompatible with —cleanup. 


—cieanup 
temoves all links to forum meetings from >udd>Project>Person>meetings that point to 
non-existent meetings. Incompatible with —check. 

~directory PATH, -dr PATH 
removes the links from the specified directory instead of the default directory of 
>udd>Project>Person>meetings. 

NOTES 


If a meeting is found through some other entry in the forum search list, the site’ S oe 
forum directory for instance, this command can not remove it. ; 


Name: remove__participant, rpt 

SYNTAX 

rpt Person_id 

FUNCTION 

makes the person identified by Person_id ineligible to participate in the current meeting. You 
can use this request if you have either modify permission on the containing directory or 
chairman access to the meeting. 


ARGUMENTS 


Person_id 
is the Person_id of the user to be removed from participation in the meeting. 


NOTES 


For information on converting a meeting, refer to "Duties of the Chairman" later in this 
manual. 
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e: remove_proiect, rpj 
SYNTAX 

rpj Project_id 
FUNCTION 


makes all participants who are currently eligible because of their Project_id, not because of 
their Person_id, ineligible to attend the current meeting. You can use this request if you 
have either modify permission on the containing directory or chairman access to the meeting. 


ARGUMENTS 


Project_id 
is the Project_id of the project whose members are to be removed from participation if 
they lack explicit Person_id participation rights. 

NOTES 


For information on converting a meeting, refer to “Duties of the Chairman” later in this 
manual. 


Name: reply, rp 

SYNTAX 

rp {transaction_specifier} {-contro!_args} 
FUNCTION 


allows a participant to build, and optionally enter into the proceedings of a meeting, a 
transaction that is in reply to an earlier transaction and thus perpetuate a "chain" of 
transactions. 


ARGUMENTS 


transaction_specifier 
is the transaction specifier of the transaction to be replied to. If this argument is not 
given, the current transaction is replied to. Transaction specifier must name only one 
transaction and therefore cannot include a User_id, regular expression, or range. 


CONTROL ARGUMENTS 


—auto_write 
does not require the "w" request to be given in the editor in order to save editing 
changes. This is only meaningful if the transaction is entered from the terminal and 
ended with \f. 
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~brief, —bf 
suppresses printing of the message indicating that the transaction was successfully entered. 


-fill, -fi 
fills the transaction after the user exits input mode. This is the default unless either the 
- -line_length control argument is used or the -line_length and -input_line_length (-ill) 
control arguments to the forum command are used. 


-force, —fc 
overwrites a previous unprocessed transaction without querying. 


~input_file pathname, -if pathname 
enters the segment identified by pathname into the proceedings. The default takes the 
transaction as it is typed in from the terminal and enters the request loop upon 
termination of input. 


-line_length LENGTH, -ll LENGTH 
fills the transaction to the specified line length. The default is 72 columns unless a 
different value was given with the -output_line_length or -line_length control arguments 
to the forum command. 


-long, —lg . 
prints a message indicating that the transaction was successfully entered. (Default) 


—meeting meeting_name, —mtg meeting _name 
enters the transaction into the proceedings of the meeting name meeting. The default 
enters the transaction into the proceedings of the meeting the user is currently attending. 
The meeting name argument can be a meeting name or a pathname. 


—no_auto_write 
requires the "w" request to be given in the editor in order to save editing changes. This 
is only meaningful if the transaction is entered from the terminal and ended with \f. 
(Default) 


-no_fill, -nf1 
does not fill the transaction to the default fill width when entered. The defauit filis ihe 
transaction, unless either the -line_length control argument is used or the -line_length 


and -input_line_length (-ill) control arguments to the forum command are used. 


-no_force, -nfc 
query before overwriting a previous unprocessed transaction. 


~no_tequest_loop, —nrql 
enters the transaction into the meeting without first entering the forum pane loop. 
(Default except when -input_file is used.) 


—request_loop, —rql 


enters the forum request loop before the transaction is entered in the meeting. (Default 
except when -input_file is used.) 
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uses subject_string as the subject, avoiding the prompt for subject. The default uses the 
subject of the transaction being replied to. If subject_string contains spaces, it must be 
quoted. 


=O} biect subject_| 


—terminal_input, -ti 
inputs the transaction from the user’s terminal. (Default) 


TERMINAL INPUT 


Unless the user makes use of the -input_file control argument, the transaction is built by 
taking lines from the user’s terminal. There are three methods of exiting from terminal input 
mode: 


Enters the transaction as is, returning to Forum request level. 


\f Exits terminal input mode and invokes the qedx editor on the transaction. 
\f or \af Exits terminal input mode and enters the Forum request loop. 
NOTES 


A transaction that was not entered via the period (.) to exit from terminal input mode can 
be entered from Forum request level via the “enter” request. See the description of the 
"enter" request for details. 


Name: reset, rs 

SYNTAX 

rs {trans_specs} {-control_arg} 
FUNCTION 


The “highest transaction seen" is only maintained for pre-MR11 version meetings. For current 
version meetings, seen switches should be used. See the description of the switch_on and 
switch_off requests. 


ARGUMENTS 


trans_specs 
iS a transaction specifier that determines the value of the transaction number that the 
index is reset to. This can refer to only one transaction. If not specified, the default is 
the current transaction number. See Section 3 for complete information on transaction 
specifiers. 


Teset . retrieve 


CONTROL ARGUMENTS 


—current 
adjusts the "current" index. (Default) 


—highest 
adjusts the “highest transaction seen" index. This control argument only applies to 
pre-MR11 version meetings. 


—new 5. 
makes the specified transaction the first “new” transaction. This is equivalent to "reset 
~highest trans_num-1". This control argument applies to pre~-MR11 version meetings. 


—next 
makes the specified transaction the “next” transaction. This is the same as "reset 
trans _num-1". 


NOTES 


The "current transaction index” is a logical pointer to a transaction in a meeting. Many 
Forum requests, including “print” and “write”, use the value of this index if no transaction 
specifiers are supplied. It is initially set to the value of the “highest transaction seen” when 
the user enters a meeting. The “highest transaction seen" index is a logical pointer to the 
highest transaction that the user has printed or written to a segment. This index is used when 
determining which transactions are "new". . 


Name: retrieve, rt 
SYNTAX 


rt trans_specs 


allows participants to retrieve specified transactions that were previously deleted with the 
*delete’ request. The chairman can retrieve any deleted transaction. Other participants can 
only retrieve transactions that they authored and subsequently deleted. 


ARGUMENTS 


trans_specs 
are transaction specifiers that determine which transactions are retrieved (see below). See 
Section 3 for complete information on transaction specifiers. Regular expressions and 
Person_ids cannot be used as transaction specifiers with this request. 
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LIST OF TRANSACTION SPECIFICATION CONTROL ARGUMENTS 


-after DT, -af DT 
selects transactions entered on or after the the date specified. The time of day is 
ignored. 


-after_time DT, -aft DT 
selects transactions entered after the date_time specified. 


-before DT, -—be DT 
selects transactions entered before the date specified. The time of day is ignored. 


-before_time DT, -bet DT 
selects transactions entered before the date_time specified. 


-between DT1 DT2, -bt DT1 DT2 . 
selects transactions entered between the dates specified, inclusive. The times of day are 
ignored. 


-between_time DT1 DT2, -btt DT1 DT2 
selects transactions entered between the date_times specified, inclusive. 


-date DT, -dt DT 
selects transactions entered on the day specified. 


-from Person_id, -fm Person_id 
selects transactions entered by the participant named Person_id. 


-subject /REGEXP/, -sj /REGEXP/ 
selects transactions whose subject matches the given regular expression. 


-text /REGEXP/, -tx /REGEXP/ 
selects transactions whose text matches the given regular expression. 


Name: retrieve_participant, rtpt 

SYNTAX 

rtpt Person_ids {-control_args} 

FUNCTION 

logically retrieves the record of participation (attendee record) of a participant in a meeting 


after it has been deleted with the "delete_participant" request. Only the chairman of the 
meeting can issue this request. 
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Tetrieve_ participant set_message 


ARGUMENTS 


Person_ids 
are the names of the participants whose records are to be retrieved. 


CONTROL ARGUMENTS 


-brief, -bf 
suppresses the message "Specified switch was not changed." 


-long, —lg 
prints the message “Specified switch was not changed." if the record for that participant 
has not been deleted. (Default) 


Name: set_ message 

SYNTAX 

set_message {-control_args} 
FUNCTION 


allows the chairman to set a message that is to be printed the first time a user enters a 
transaction after entering a meeting. The message is also printed the first time a user goes to 
the meeting after the message has changed. The message has a maximum size of 256 
characters. 


CONTROL ARGUMENTS 


-fill, -fi 
fills the message after the user exits input mode. This is the default unless the 
-no_input_fill (-nif) control argument was given with the invocation of forum. The 
default fiii widin is 7Z, Dui ithe user can specify the fill width via the —line_length NN 
(-Il NN) control argument to the forum command. 


-input_file pathname, -if pathname 
enters the segment identified by pathname into the proceedings. The default takes the 
message as it is typed in from the terminal and enters the request loop upon termination 
of input. 


-no_fill, -nfi 
does not fill the message to the default fill width when entered. The default fills the 
transaction unless the -no_input_fill (-nif) control argument was specified when forum 
was invoked. The fill width defaults to 72, unless the -line_length NN (-ll NN) control 
argument was specified when forum was invoked. (Default) 
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—no_request_loop, nrql 
enters the message into the meeting without first entering the forum request loop. 
(Default except when -input_file is used.) 


-request_loop, -rql 
enters the forum request loop before entering the message in the meeting. 


-terminal_input, -ti 
inputs the message from the user’s terminal. (Default) 


TERMINAL {NPUT 


Unless the user makes use of the ~input_file control] argument, the message is built by taking 
lines from the user’s terminal. There are three methods of exiting from terminal input mode: 


Enters the message as is, and returning to Forum request level. 
\f Exits terminal input mode and invokes the qedx editor on the message. 
\q Exits terminal input mode and enters the Forum request loop. 
NOTES 
To change a message, simply set the new message with “set_message”. 
A message that was not entered via the period (.) exit from terminal input mode can be 


entered from Forum request level via the "enter" request. See the description of the "enter" 
Tequest for details. 


Name: subject, sj 

SYNTAX 

sj {new subject} {-control_args} 
SYNTAX AS AN ACTIVE REQUEST 
[sj {mew_subject} {-control_args}] 
FUNCTION 


changes the subject of the unprocessed transaction or prints/returns the subject of the 
unprocessed transaction. 


mire «a AA 
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subject subsysiem_name 


ARGUMENTS 


new_subject 
is a string formed by concatenating the non-control arguments with intervening spaces. It 
becomes the subject of the unprocessed transaction. 


CONTROL ARGUMENTS 


—defauit 
changes the subject to that of the transaction that the unprocessed transaction is in reply 


to. This control argument can only be used with replies and cannot be used if 
new_subject is given. 


-—subject, -sj 
begins the subject with the next argument. Useful if the first character of the subject is 


NOTES 


When given no arguments, the subject request prints or returns the current subject of the 
unprocessed transaction, if any. An wmnprocessed transaction is a transaction that has been 
“built” by the user, either by exiting the "talk" request with the "\q" request or by using the 
“gedx" or “ted" requests; but has not yet been entered info a meeting. 


Name: subsystem__name 

SYNTAX 

subsystem_name 

SYNTAX AS AN ACTIVE RFEOUFST 
[subsystem_name] 


FUNCTION 


prints the name of the subsystem; as an active request, returns the name of the subsystem. 
This is useful in abbrevs that are used in more than one subsystem. 


7-53 CY74-02 


subsystem_ version switch_off 


Name: subsystem__version 

SYNTAX 

subsystem_version 

SYNTAX AS AN ACTIVE REQUEST 
[subsystem_version] 

FUNCTION 


prints the version number of the subsystem; as an active request, returns the version number 
of the subsystem. 


Name: switch_off, swf 

SYNTAX 

swf switch_name {-control_args} 
FUNCTION 

turns off various Forum switches. 
ARGUMENTS 


switch_name 
is the name of the switch to reset. See "List of Switches" below. 


CONTROL ARGUMENTS 
-brief, bf 


suppresses the "Specified switch was not changed" error message which is printed when 
the user tries to set a switch that is already off. 


~meeting meeting name, —-mtg meeting_name 
sets the switch for the meeting identified by meeting_name. 


-user Person_id 
sets the switch for the user identified by Person_id. Only the chairman can set another 
user’s flag. 

LIST OF SWITCHES 


adjourned, adj 
reconvenes the meeting and allows users to attend the meeting again. 
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meeting_eligibility_messages, mtg_emsg 
turns off the printing of eligibility messages for the meeting. This switch can only be 
reset by the chairman, and can only be reset if the site administrators allow it. (The 
default is site-dependent--see Appendix A.) 


notify, nt 
turns off the notify switch for the meeting. (This is the defauit.) 


participating, part 
turns off the participation switch for the meeting. (The default is on.) 


safety 
turns off the storage system safety switch for this meeting. The switch will cause the 
delete command to query the user before the meeting is deleted. 


seen TRANS_SPECS 
marks the specified transactions as not having been seen. 


Name: switch_on, swn 

SYNTAX 

swn switch_name {control_args} 
FUNCTION 

turns on various Forum switches. 
ARGUMENTS 


switch_name 
is the name of the switch to set. See "List of Switches” below. 


CONTROL ARGUMENTS 


-brief, ~bf 
suppresses the "Specified switch was not changed" error message which is printed when 


bi ° e a 
the user tries to set a switch that is already on. 


—meeting meeting_name -—mtg meeting_name 
sets the switch for the meeting identified by meeting_name. This control argument cannot | 
be used with the "seen" switch. 


—user Person_id 


sets the switch for the user identified by Person_id. Only the chairman can set another 
user’s flag. 
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LIST OF SWITCHES 


adjourned, adj | 
prevents users from entering the meeting. Only the chairman can set this switch. 


meeting_eligibility_messapes, mtg_emsg 
turns on the printing of eligibility messages for the meeting. This switch can only be set 
by the chairman. (The default is site dependent--see Appendix A.) 


notify, nt 
turns on the notify switch for the meeting. This means that an interactive message will 
be sent each time a transaction is entered if the user is logged in and has issued the 
forum_accept_notifications command (described in Section 8). (The default is off.) 


participating, part 
turns on the participation switch for the meeting. (This is the default.) 


safety ee 
turns on the storage system safety switch for this meeting. The switch will cause the 
delete command to query the user before the meeting is deleted. 


seen TRANS_SPECS 
marks the specified transactions as not having been seen. This means that the transaction 
has been printed, written or explicitly marked as seen by the switch_on request. Type 


"help trans_specs" for information on transaction specifiers and for an explanation of the 
seen switch. 


Name: talk, t 
SYNTAX 

t {-control_args} 
FUNCTION 


allows a participant to build, and optionally enter into the proceedings of a meeting, a new 
transaction. 


CONTROL ARGUMENTS 


—auto_write 
does not require the "w" request to be given in the editor in order to save editing 
changes. This is only meaningful if the transaction is entered from the terminal and 
ended with \f. 


-brief, —bf 
suppresses the message that says that the transaction was successfully entered. 
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~fill, -fi 
fills the transaction after the user exits input mode. This is the default unless either the 
-line_length control argument is used or the -line_length and -input_line_length (-ill) 
control arguments to the forum command are used. 


-force, -fc 
overwrites a previous unprocessed transaction without querying. 


-input_file pathname, —if pathname 
enters the segment identified by pathname into the proceedings. The default takes the 
transaction as it is typed in from the terminal and enters the request loop upon 
termination of input. 


-line_length LENGTH, -ll LENGTH 
fills the transaction to the specified line length. The default is 72 columns unless a 
different value was given with the -output_line_length or —line_length control arguments 
to the forum command. 


-long, —lg 
prints a message indicating that the transaction was successfully entered. (Default). 


-meeting meeting_name, -—mtg meeting_name 
enters the transaction into the proceedings of the meeting_name meeting. The default 
enters the transaction into the proceedings of the meeting the user is currently attending. 
The meeting name argument can be a meeting name or a pathname. 


~no_auto_write 
require the "w" request to be given in the editor in order to save editing changes. This 
is only meaningful if the transaction is entered from the terminal and ended with \f. 


~no_fill, —-nfi 
does not fill the transaction to the default fill width when entered. The default fills the 
transaction unless the -line_length control argumentis used or the -line_length and 
-input_line_length (-ill) control arguments to the forum command are used. 


—no_force, —nfc 
query before overwriting a previous unprocessed transaction. 
-no_request_loop, -nrql 


enters the transaction into the meeting without first entering the forum request loop. 
(Default except when -input_file is used.) 


~request_loop, —rq! 
enters the forum request loop before entering the transaction in the meeting. 


-subject subject_string, -sj subject_string 
uses subject_string as the subject, avoiding the prompt for subject. The default prompts 
the user for the subject. If subject_string contains spaces, it must be quoted. 

-terminal_input, -ti 
inputs the transaction from the user’s terminal. (Default) 
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TERMINAL INPUT 


Unless the user makes use of the -input_file control argument, the transaction is built by 
taking lines from the user’s terminal. There are three methods of exiting from terminal input 
mode: 


Enters the transaction as is, returning to Forum request level. 


\f Exits terminal input mode and invokes the qedx editor on the transaction. 
\q Exits terminal input mode and enters the Forum request loop. 
NOTES 


A transaction that was not entered via the period (.) to exit from terminal input mode can 
be entered from Forum request level via the "enter" request. See the description of the 
"enter" request for details. 


Name: ted 

SYNTAX 

ted {-control_arg} 
FUNCTION 


invokes the “ted” editor to edit the text of the unprocessed transaction or to build a new 
transaction. 


CONTROL ARGUMENTS 


—auto_write 
specifies that the "w" request is not required to save editing changes. See "Notes". 


-fill, -fi 
specifies that the transaction is to be refilled upon exit from the editor. This is the 
default unless the -no_input_fill control argument was given to the forum command or 
unless the ~no_fill control argument was given to the talk or reply request. 


-no_fill, -nfi 
specifies that the transaction is not to be refilled upon exit from the editor. This is the 
default unless the —no_input_fill control argument was given to the forum command or 
unless the -no_fill control argument was given to the talk or reply request. 


—no_auto_write 


specifies that the “w" request is required in order to save editing chnages. See “Notes”. 
(Default) 
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NOTES 


If auto_write is not specified, the write (w) request must be used to save any changes made 
to the transaction back to forum. The write request can be used as often as desired to 
checkpoint the editing process. 


If the quit (q) request is issued and the transaction has been modified since it was last 
written, ted will query for permission to exit. If permission is given, any changes made since 
the last write request will be lost. The quit-force (qf) request can be used to abort unwanted 
editing of the transaction without being queried. 

If issued before use of the write request, the request line: 


! 1,$dr 


will restore the original transaction text to the buffer. If given after a write request, this 
request line will restore the transaction as saved by the last write request given in the buffer. 


Name: unmake__public, ump 
SYNTAX 

ump 

FUNCTION 


makes all users not explicitly eligible to participate in the current meeting ineligible. Users 
are made eligible to participate by using the add_participant and add_project requests. You 
can use this request if you have either modify permission on the containing directory or 
chairman access to the meeting. 


NOTES 


For information on converting a meeting, refer to "Duties of the Chairman" later in this 
manual. 


7-59 | CY74-02 


write write 


SYNTAX 

w {trans_specs} {-control_args} 
FUNCTION ) 

writes the selected transactions into a segment. 


ARGUMENTS 


trans_specs 
are transaction specifiers that determine the transactions to be written. See "List of 
transaction specification control arguments” below. See Section 3 for complete information 
on transaction specifiers. If no transaction specifiers are supplied, the current transaction 
is written. 


CONTROL ARGUMENTS 


~brief, —bf 
suppresses the message about how many transactions were written. 


~by_chain 
specifies that transactions are to be grouped by transaction chain. 


extend 
writes the selected transactions to the end of the segment named either by the —pathname 
control argument or by default (see "Notes" below). (Default) 


-fill, -fi 
fills transactions before writing them to the file. The default is to fill transactions 
marked as unfilled when entered. The default line length is 72 unless another value is 
specified with the -line_length control argument or with the -line_length or 
—output_line_length control argument to the forum command. 


~format, -—fmt 
specifies that transactions are to be written in a formatted fashion which includes page 
breaks. See "Notes on formatting" below. 


~include_deleted, -id] 
selects transactions even if they have been deleted. See "Notes" below. Default is 
—only_non_deleted. 

~initial 
writes only transactions that are at the beginning of transaction chains. 


-line_length LENGTH, -ll LENGTH 
fills transactions to LENGTH characters. (Default = 72) 
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-long, —lg 
prints the message about how many transactions were written. (Default) 


~-meeting meeting_name, —mtg meeting name 
selects the specified transactions from the meeting_name meeting. The default selects 
transactions from the current meeting. 


-no_fill, -nfi 
does not fill transactions when written. The default fills only transactions that were 
marked as unfilled when entered. 


-no_format, -nfmt 
specifies that transactions are to be written with no page breaks, headers, or footers. 
(Default) 


—no_separator, —nsep 
writes out transactions with a single blank line between them. 


-only_deleted, -odl 
selects only deleted transactions. See "Notes" below. Default is -only_non_deleted. 


-only_non_deleted, -ondl 
selects only non-deleted transactions. (Default) 


-page_length LENGTH, -pl LENGTH 
specifies the number of lines to be printed on each page. LENGTH includes the page 
header and footer. This control argument is only applicable if -format is given. (Default 
= 60) 


—pathname PATH, -pn PATH 
writes the transactions selected to the segment identified by PATH. The ".trans” suffix is 
assumed. 


-revetse, —IV 
writes transactions in the reverse order of that given in the transaction specifier. 


~separator STR, -sep STR 
appends a separator string to each transaction written to the output segment. STR is an 
ioa_ control string of up to 256 characters. Default is a new page ("|"). 


-truncate, —tc 
truncates the segment before writing the transactions to it. 


LIST OF TRANSACTION SPECIFICATION CONTROL ARGUMENTS 

-after DT, -af DT 
selects transactions entered on or after the the date specified. The time of day is 
ignored. 

-after_time DT, -aft DT 
seiecis transactions eniered after the date_time specified. 
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-before DT, -be DT | 
selects transactions entered before the date specified. The time of day is ignored. 


-—before_time DT, -bet DT 
selects transactions entered before the date_time specified. 


-between DT1 DT2, -bt DT1 DT2 | 
selects transactions entered between the dates specified, inclusive. The times of day are 
ignored. 


-between_time DT1 DT2, -btt DT1 DT2 
selects transactions entered between the date_times specified, inclusive. 


-date DT, -dt DT 
selects transactions entered on the day specified. 


-from Person_id, -fm Person_id 
selects transactions entered by the participant named Person_id. 


subject /REGEXP/, -sj /REGEXP/ 
selects transactions whose subject matches the given regular expression. 


—text /REGEXP/, -tx /REGEXP/ 
selects transactions whose text matches the given regular expression. 


NOTES 


If no pathname is given, the selected transactions are written to a segment in the working 
directory with the entryname meeting_name.trans. The user’s current transaction index is set 
to the last transaction written. 


In order to write a deleted transaction, the user must be either the chairman of the meeting 
or the author of the deleted transaction. 


NOTES ON FORMATTING 


Formatted output consists of a page header containing the current date and time, the name of 
the meeting, and the page number, plus a footer containing the subject of the first 
transaction on the page. The header and footer are separated from the text by a line of 
underscores and a blank line. Transactions are only split across pages if they are longer than 
one page. If a transaction does not fit on the remainder of the current page, a new page is 
always created. The ~separator control argument cannot be used when formatting output. 
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SECTION 8 
USER COMMANDS 


This section contains descriptions of the Forum users’ commands, presented in 
alphabetical order. These commands are for all Forum users, that is, for anyone who wants 
to find out about and attend meetings. Each description contains the name of the command 
(including the abbreviated form, if any), discusses the purpose of the command, and shows 
the correct usage. Notes and examples are included when deemed necessary for clarity. 


The syntax line demonstrates the proper format to use when invoking the command. 
The following conventions apply in the usage line: 


1. Optional arguments are enclosed in braces (e.g., {path}, {User_ids}). All other 
arguments are required. 


2. Control arguments are identified in the usage line with a leading hyphen (e.g., 
{-control_args}) simply as a reminder that all control arguments must be 
preceded by a hyphen in the actual invocation of the command. 


3. To indicate that a command accepts more than one of a specific argument, an 
"s" is added to the argument name (e.g., paths, ipaths}, {-control_args}). 
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Name: forum 

SYNTAX AS A COMMAND 

forum {meeting_name} {-control_args} 
FUNCTION 


The forum command enters the Forum interactive meeting system. Once the command is 
invoked, you are placed in the Forum subsystem, where you must use Forum requests. Forum 
Tequests are listed below under "List of Requests". (Forum requests are treated tutorially in 
Sections 2 through 5, and are fully described in Section 7.) 


ARGUMENTS 


meeting_name . 
is the name or pathname of the meeting to be entered immediately upon invoking 
Forum. If a pathname is specified, it identifies the meeting to enter. Otherwise, Forum 
searches for meeting_name by using the forum search list. See “Notes on Search List" 
below. 


CONTROL ARGUMENTS 


-abbrev, -ab 
specifies that abbreviation processing should be done by the Forum request processor. If 
the -profile argument is not given, the user’s default profile segment 
(>udd>Project_id>Person_id>Person_id.profile) is used. 


-brief, —bf 
suppresses some messages from Forum and shortens others. 


-input_fill, -ifi 
fills transactions before entering them into the proceedings of a meeting. See “Notes on 
Filling” below for a discussion of filling. (Default) 


-input_line_length N, -ill N 
causes input filling (fill request and default filling) to be done with line length N. 
(Default is 72) 


-line_length N, -ll N 
causes both input and output filling (fill request and default filling) to be done with line 
length N. (Default is 72) 


-list {trans_spec}, -Is {trans_spec} 
lists the specified transactions before entering the request loop. If no transaction specifier 
is given, all the transactions in the meeting are listed. 


-long, —lg 
uses long messages from Forum. (Default) 
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—meeting meeting_name, mtg meeting_name 
enters the meeting whose entryname or pathname is meeting name. See the description of 
the meeting name argument above. 


—no_abbrev, -nab 
specifies that abbreviation processing is not to be done by the Forum request processor. 
(Default) | 


~no_input_fill, -nif 
does not fili transactions before entering them into the proceedings of a meeting. See 
"Notes on Filling" below for a discussion of filling. 


—no_output_fill, —nof 
does not fill transactions before printing them on the user’s terminal. See "Notes on 
Filling" below for a discussion of filling. (Default) 


—no_prompt 
does not prompt in the request loop. 


—no_start_up, —nsu 
does not execute the start_up exec_com. See "Notes on start_up" below. 


—output_fill, -ofi 
fills transactions before printing or writing. See “Notes on Filling” below for a discussion 
of filling. 


-output_line_length N, —oll N 
causes output filling (fill request and default filling) to be done with line length N. 
(Default is 72) 


-profile profile_path, —pf profile_path . 
specifies that abbreviation processing is to be done using the profile named profile_path. 
If this control argument is given, the -abbrev argument need not be given. 
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sets the request loop prompt to prompt_string. (Default is “forum:") 

quit 
tells Forum to process the initial request line and then return without entering the 
request loop (even if the initial request line is aborted). 


—request string, -rq string 
executes the requests in string before entering the request loop. 


-start_up, —su 
executes the start_up exec_com. See "Notes on start_up" below. (Default) 


NOTES ON REQUESTS 


Request lines use () for iteration, "" for quoting, and [] to invoke Forum active 
requests (listed below under "List of Active Requests"). 
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Any request line that begins with ".." is passed directly to the Multics command 
processor with the leading ".." stripped off. Consequently, any reference to an active function 
is evaluated by the Multics command processor. The “execute” (e) forum request can also 
make use of active strings via the square brackets ([]), but these are evaluated as active 
requests by Forum before the command line is passed to the Multics command processor. 


NOTES ON START_UP 


If the -no_start_up control argument is not given, forum will search for and execute an 
exec_com file of forum requests. It will look for a segment named "start_up.fmec" in the 
home directory, project directory, and >site in that order. The start_up will be executed 
before going to the initial meeting and before executing the initial request line. 


NOTES ON F/LLING 


Transactions can be filled out to a given line length on both input and output. By 
default, all transactions input from the terminal are filled to a line length of 72 upon entry. 
The -input_fill (-if) and -no_output_fill (-nof) control arguments are the default. These 
control arguments specify a global attribute for the invocation of Forum, which can be 
overridden by control] arguments associated with the various requests for inputting and 
outputting transactions (such as the -no_fill control argument to the "print" request). The 
-input_fill and -no_input_fill control arguments do not affect transactions entered using the 
-input_file control argument to the talk and reply requests. The fill width can be altered by 
control arguments to the forum command  (-line_length, -input_line_length, and 
—output_line_length) and by the -line_length control argument to the forum requests that fill 
transactions. 


LIST OF REQUESTS 


Listed below are the available requests that you can use once you are in the Forum 
subsystem. These requests are described in detail in Section 7. Certain common requesis are 
described tutorially in Sections 2 through 6 of this manual. 


? 
lists the available forum requests and active requests. 


identifies Forum with version number; gives meeting_name if attending; gives count of 
new, total, last, and current transactions; and gives number of lines in the unprocessed 
transaction. 


abbrev {-control_args}, ab {-control_args} 
turns abbreviation processing on or off and changes profile segments. 


add_meeting . 
adds a. meeting to the list of meetings attended. Makes the user a participant of the 
meeting. 


add_participant NAME {-control_arg}, apt NAME {-control_args} 
allows a user to participate in the meeting. (A chairman request only). 
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add_project NAME {-control_arg}, apj NAME {-control_args} 
allows a project to participate in the meeting. (A chairman request only). 


announce_meeting 
places an announcement of the current meeting in another meeting. This announcement 


can be used with the add_meeting request by other users to add this meeting to their 
search list. 


announcement_info 


extracts information from a meeting announcement produced by the announce_meeting 
request. 


answer STR {-control_args} request_line 
supplies an answer to a question asked by a request. STR is the desired answer to th 
question and request_line is the Forum request line. 


apply command_line, ap command_line 
places the unprocessed transaction into a temporary segment, concatenates command_line 
with the pathname, and passes the result to the Multics command processor. The 
temporary segment is then read back in as the unprocessed transaction. 


chairman {meeting name}, cm {meeting_name} 
prints the User_id (Person_id.Project_id) of the meeting’s chairman. 


check_ meetings 
establishes a list of meetings to be flagged when changed. The meeting can be 
successively viewed with the next_meeting (nm) request. 


current_meeting {-control_args}, cmtg {-control_args} 
prints the name of the current meeting. 


delete trans_specs, dl trans_specs 
allows the chairman to delete specified transactions from the proceedings. 


do {request_line} {args}, do {-control_args} 
substitutes args into the request_line and passes the result to the Forum request processor. 
Control arguments can be -nogo to suppress execution or —long (-ig) to display expanded 
line before execution. 


enter {-control_args}, en {-control_args}, send {-control_args} 
enters the unprocessed transaction into the proceedings of a meeting. 


exec_com PATH STRs, ec PATH STRs 
executes an exec_com segment containing forum requests where PATH is the pathname of 


the exec_com segment (the ".fmec” suffix is assumed) and STRs are arguments to be 
passed to the program. 


execute STRs, e STRs 


executes STRs as a Multics command line after evaluating Forum active requests. As an 
_active request, returns the result of evaluating strings as an Multics active string. 
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fill {-control_args}, fi {-control_args} 
reformats transaction text to fit in a given line length. 


forum_dir, fd 
prints the pathname of the central forum directory. 


goto meeting name, g meeting _name 
enters the user into the meeting_name meeting. 


help {STR} 
prints information about request names or topics. A list of available topics is produced 
by the list_help request. 


if EXPR -then LINEi {-else LINEZ} 
conditionally executes one of two request lines depending on the value of an active 
string. EXPR is the active string that must evaluate to either “true” or "false". LINE1 is 
the Forum request line to execute if EXPR evaluates to "true". LINE2 is the Forum 
tequest line to execute if EXPR evaluates to "false". oe 


list {trans_specs} {-control_args}, Is {trans_specs} {-control_args} 
prints a summary of the specified transactions. 


list_help {topics}, lh {topics} 
prints a list of available info segments whose names include a topic string. 


list_meetings {meeting_names} {-control_args} , Ism {meeting_names} {-control_args} 
prints a list of selected meetings and information about them. 


list_requests {-control_args}, Ir {-control_args} 
prints information about forum requests. 


list_users {-control_args}, lsu {-control_args} 
prints information about specified participants in a meeting. 


mail 
sends a transaction or set of transactions to other users, mailing lists, or forum meetings 
using the Multics mail system. 


make_public, mp 
allows all users on the system access to the meeting. (A chairman request only.) 


next_meeting 


changes the current meeting to the next meeting in the list of changed meetings 
established by the check_meetings request. 
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print {trans_specs} {-control_args}, pr {trans_specs} {-control_args} 
prints selected transactions from a meeting. 


qedx, qx 
invokes the qedx editor on the unprocessed transaction. 


quit {-control_arg}, q {-control_arg} 
exits Forum. 


| 
Tremove_meeting | 
removes meetings to the user’s forum search list by deleting links to them from the | 
directory >udd>Project>Person>meetings. | 
remove_participant NAME, rpt NAME 
denies the user permission to participate in the meeting. (A chairman request only.) 


remove_project NAME, rpj NAME 
denies users on a project permission to participate in the meeting. (A chairman -request 
only.) 


reply {trans_spec} {-control_args}, rp {trans_spec} {-control_args} 
enters/Duiids a new transaction in a meeting that has as its subject a reference to some 
other transaction in the form "Re: <some other subject>", and which will be logically 
linked to the transaction specified by trans_spec. . 


reset {trans_spec} {-controi_args}, rs {trans_spec} {-control_args} 
resets the user’s current or highest-seen transaction index to the specified transaction. 


retrieve trans_specs, rt trans_specs 
Tetrieves specified transactions that were previously deleted with the "delete" request. 
Only the chairman or the author of the deleted transaction can use this request. 


set_message {-control_args} 
sets a greeting message for the meeting. The default action puts the user into input 
mode to snecify the message. (A chairman request only.) 
subject {strings}, sj {strings} 
prints or modifies the subject of an unprocessed transaction. If strings are supplied, they 
are catenated together to become the new subject. If no strings are supplied, the current 
subject is printed. 


subsystem_name 
prints the name of the subsystem ("forum"). 


subsystem_version 
prints the current version of Forum. 
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switch_off switch {-control_args}, swf switch {-control_args} 
turns off various Forum switches. Switches are: 


adjourned, adj 
meeting_eligibility_messages, mtg_emsg 
notify, nt 

participating, part 


switch_on switch {-control_args}, swn switch {-control_args} 
turns on various Forum switches. Switches are: 


adjourned, adj 
meeting_eligibiility_messages, mtg_emsg 
notify, nt 

participating, part 


talk {-control_args} 
enters/builds a new transaction in a meeting. 


ted 
invokes the ted editor on the unprocessed transaction. 


unmake_public, ump 


allows only users granted explicit permission to participate in the meeting. (A chairman 
request only.) 


write {trans_specs} {-control_args}, w {trans_specs} {~-control_args} 
writes selected transactions to a segment. 


LIST OF ACTIVE REQUESTS 


[chairman {meeting_name}], [cm {meeting_name} ] 
returns the Person_id.Project_id of meeting chairman. 


{current_meeting {-control_args}], [cmtg {-control_args} ] 
returns the name of the current meeting. 


[do {request_string} {args} ] 
returns expanded request string. 


{exec_com PATH STRs], [ec PATH STRs] 
executes an exec_com segment containing forum requests. 


[execute STRs], [e STRs] 
invokes Multics active function within forum request line. 


{forum_dir], [fd] 
returns absolute pathname of central forum directory. 
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forum forum 


fif EXPR -then STR1 {-else STR2}] 
returns one of two character strings to the Forum Tequest processor depending on the 
value of EXPR. EXPR is the active string that must evaluate to either "true" or "false". 
STR1 is returned if EXPR evaluates to "true". STR2 is returned if EXPR evaluates to 
"false". 


[list_meetings {-control_args}], [lsm {-control_args} ] 
returns names of meetings that have new transactions. 


[list_users {-control_args}], [lsu {-control_args} ] 
return names of participants matching given conditions. 


| 
[next_meeting] | 
returns the name of the next meeting in the list of changed meetings established by the | 
check_meetings request. | 
[subject], [sj] 
returns the subject of an unprocessed transaction. 


{subsystem_name] 
returns the name of the subsystem ("forum"). 


[subsystem_version] 
returns the current version of Forum. 


TRANSACTION SPECIFIERS 


Transaction specifiers identify transactions. They are used as arguments to the forum requests 
that act on transactions. In addition, there are several requests and active requests that return 
information about transaction numbers. See Section 3 for complete information about 
transaction specifiers. 


NOTES ON SEARCH LIST 


The forum command uses the "forum" search path. For more information about search paths, 


wesw awa we. 


see the descriptions of the search facility commands in the Commands manual. For details on 
the forum search path, see Section 2. 
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forum_accept_notifications forum_accept_notifications 


Name: forum_accept__notifications, fant 

SYNTAX AS A COMMAND 

fant 

FUNCTION 

enables reception of interactive messages notifying the user of new transactions being entered 
in meetings for the duration of this login session. Notifications are enabled for all meetings 


for which the user has set the notify flag. See the description of the switch_on request in 
Section 7 to find out how to set the notify flag. 
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forum_add_meeting | forum_add_meeting 


Name: forum__add__meeting, fam 

SYNTAX 

fam {trans_specs} {meeting _names} {-control_args} 
FUNCTION | 


adds meetings to the user’s forum search list by placing links to them in the directory 
>udd>Project>Person>meetings, and makes the user a participant in the meeting. 


ARGUMENTS 


trans_specs 
are transaction specifiers identifying transactions created by the announce_meeting request. 
If any trans_specs are given, they must precede all meeting_names. At least one 
trans_spec or meeting_name must be given. See Section 3 for more information on 
transaction specifiers. —_ 


meeting names 
are pathnames of forum meetings to be added to the search list. 


CONTROL ARGUMENTS 


—current_meeting, ~cmtg 
adds the current meeting to the search list. 


-directory PATH, -dr PATH 
places the links in the specified directory instead of the default directory of 
>udd>Project>Person>meetings. 


-force, ~—fc 
adds the link even if the user is not eligible to participate in the meeting. 


-no_force, -nfc 
does not add the link if the user is not eligible to participate in the meeting. (Default) 


-update, —ud 
changes all links to pre-MRil meetings into links to a current version meeting if that 
meeting exists in the directory that the link points to. For more information on 
converting a mecting, refer to “Duties of the Chairman” ijater in this manual. 


NOTES 
If the directory >udd>Project>Person>meetings does not exist, and the -directory control 


argument is not given, a link with that name pointing to >udd>Project>Person is created in 
>udd>Project>Person. 
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forum_delete forum_delete 


Name: forum__delete, fdl 
SYNTAX AS A COMMAND 
fdl meeting _name 
FUNCTION 

deletes the specified meeting. 
ARGUMENTS 


meeting name 
is the pathname or entryname of the meeting to be deleted. Pathnames contain 
greater-than (>) or less-than (<) characters. If a pathname is specified, it identifies the 
meeting to be deleted. Otherwise, fdl searches for the meeting_name by using the forum 
search path. 


ACCESS REQU/RED 


The user must have "m" access to the directory containing the meeting to delete the meeting. 


NOTES 

If you are using this command to delete a pre-MR11 version meeting that has been converted 
to a current version meeting, you must use the suffix “.control” after the meeting name. The 
syntax is: 


fdl meetingname.control 


For information on converting a meeting, refer to "Duties of the Chairman” later in this 
manual. 
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forum_dir forum_dir 


Name: forum__dir, fd 

SYNTAX AS A COMMAND 

fd 

SYNTAX AS AN ACTIVE FUNCTION 

[fd] 

FUNCTION 

prints/returns the absolute pathname of the central meeting directory. 
NOTES 


The central forum directory is the location for site-approved public meetings. This directory 
is included in the default forum search path. 
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forum_list_meetings forum_list_meetings 


Name: forum__iist_meetings, fism 
SYNTAX AS A COMMAND 

fism {meeting_names} {-control_args} 
SYNTAX AS AN ACTIVE FUNCTION 
[flsm {-control_args}] 


FUNCTION 


prints a list of selected meetings on the user’s terminal. For each meeting selected, 
information about the names of the meeting and per-user meeting attributes are listed. 


ARGUMENTS 


meeting _names ’ 
are optional meeting _names. If any are supplied, information about only the specified 
meeting_names is printed. The star convention is supported for meeting_names. If no 


meeting_names are given, information for all meetings found in the forum search path is 
printed. 


CONTROL ARGUMENTS 


-absolute_pathname, -absp 


prints the absolute pathname of a meeting. The default lists the long and short meeting 
names only. 


~adjourned, —adj 
selects information about meetings that have been adjourned. 


~all, -a 
prints information about all meetings. The default prints information about the meetings 
in which the user is eligible to participate only. 


~brief, —bf 


suppresses the message "No meetings have changed" which is printed by default if the 
~changes control argument is used and no meetings have changed. 
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forum_list_meetings forum_list_meetings 


~chairman {Person_id}, -cm {Person_id} 
prints information about meetings of which Person_id is chairman. If Person_id is not 
given, the user’s Person_id is used. 


-changed, —chg 
prints information about meetings in which the user is a participant and new transactions 
have been entered. 


—-count, —ct 
prints out the number of new transactions for a meeting in which the user is 
participating. This control argument cannot be used if forum_list is invoked as an active 
function. 


~eligible, ~elig 
prints information about all meetings in which the user is eligible to participate. 
(Default) 


~exclude meeting_names, -ex meeting_names 
excludes the meetings identified by meeting_names from the output list. This ential 
argument is designed to be used when a starname has been supplied as meeting_names in 
order to exclude the specified meetings from being selected. The default (—include) is to 
select all meetings that match the specified starname. 


~from DT, -fm DT 
_ Selects meetings which have changed since the specified time. DT is any string acceptable 
to the convert_date_to_binary_ subroutine. The default is the current time. 


~-header, —he 
prints the meeting header. This is the default, unless the -changes control argument was 
supplied. 


-include meeting_names, —inc] meeting_names 
includes the meetings identified by meeting names in the output list. This control 
argument is intended to be used when a starname has been specified for selecting 
meetings. (Default) 


-inhibit_error, —ihe 


does not print warning messages for such as things as bad meeting format and errors 
encountered while searching for meetings. (Default) 


prints the message "No meetings have changed" if the -changes control argument is used 
and no meetings in which the user is a participant have changed. (Default) 
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forum_list_meetings 


—no_changes, —nchg 
does not list changed meetings. 


-no_adjourned, —nadj 
does not list adjourned meetings. 


-no_header, ~nhe 
suppresses printing of the meeting header. 


-no_inhibit_error, —nihe 
prints all warning messages. 


-no_notify, -nnt 
does not list meetings in which the user has the notify flag set. 


—no_participating, ~npart 
does not list meetings in which the user is a participant. 


~no_read_only, -nro 
does not list meetings to which the user has only read access. 


-notify, —nt . 
lists only meetings in which the user has the notify flag set. 


~participating, —part 


forum_list_meetings 


lists only meetings in which the user is participating. The default prints information 


about all meetings that the user is eligible to participate in. 


-read_only, -To 
lists just the meetings to which the user has only read access. 


~user User_id 


determines participation, eligibility, and changes attributes for the user specified by 
User_id. User_id is in the form Person_id.Project_id.tag, where any of the components 
can be the character "*". If a component is omitted, it is assumed to be "*”. 


-verbose, —vb 


prints the chairman’s User_id and current and last transactions for each meeting. This 
control argument cannot be used with the -changes control argument or when invoking 


flsm as an active function. 
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forum_list_meetings forum_list_meetings 


NOTES ON FLAGS 


The output from this command may include flags that have the following interpretation: 


a 


i) 


attending flag 
the user is currently attending the meeting 


change flag 
new transactions have been entered in the proceedings of the meeting since the 
user last attended this meeting. 


eligible flag 
the user can participate in the meeting. 


adjourned flag 
the chairman has temporarily adjourned the meeting. 


notify flag _ 
the user has turned on the notify flag in the meeting (i.e., the user has 
requested online notification when new transactions are entered in the meeting). 


observer flag 


the user has only read access to the meeting. 


participant flag 
the user is a participant in meeting (ic, has gone to the meeting at least 
once). 


removed flag 
the user has removed himself from participation in the meeting. 


The flags corresponding to the selection criteria are not shown (i.e., if the user is selecting 
meetings to which he is eligible, the "e" flag is not printed, it is assumed). 
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forum _list_users forum_list_users 


Name: forum__list__users, flsu 


SYNTAX AS A COMMAND 

flsu {meeting_name} {-control_args} 
SYNTAX AS AN ACTIVE FUNCTION 
[fisu {meeting_name} {-control_args}] 
FUNCTION 


prints a list of selected participants of a meeting. For each participant selected, the 
Person_id, Project_id, current transaction number (last one seen), the date/time last attended, 
and severai flags are listed. As an active function it returns a list of Person_ids. 


ARGUMENTS 


meeting_name 
is the name or pathname of the meeting for which participants are to be listed. Either 
this argument or the —meeting control argument (but not both) must be given. 


CONTROL ARGUMENTS 


-after TIME, -af TIME 
lists only those participants who have attended since the given time. 


all, —a 
lists all participants, including those who are not participating in the meeting. 


-ascending, —asc 
sort in ascending order. This is the default for sorting by name. This may not be used 
if invoked as an active request. 


-attending, —at 
lists only participants who are currently attending this meeting. 


~before TIME, -ne TIME 
| lists only those participants who have not attended since the given time. 


~brief, —bf 
Suppresses the message "No participants were selected.” 


sort in descending order. This is the default for sorting by time last attended. This 


| 
| ~descending, —dsc 
| contro] argument cannot be used if list_users is invoked as an active request. 


forum_list_users forum_list_users 


-eligible, —elig 
prints a list of users and projects that are eligible to attend the meeting. Read-only 
eligibility is denoted by an asterisk (*). This control argument cannot be used if 
list_users is invoked as an active request. This control argument cannot be combined with 
any other control argument. 


~header, —he 
prints the header. prints the header. This control argument cannot be used if list_users 
is invoked as an active request. (Default) 


~long, —lg 
prints the "No participants were selected." message if this is the case. (Default) 


-meeting meeting_name, -mtg meeting_name 
lists participants of the meeting name meeting. The meeting_name argument can be either 
a name or a pathname of a meeting. The default lists participants of the current 
meeting. 


—names_only 
only prints the names of the selected participants. This control argument is not valid if 
names_only is invoked as an active request. 


-no_header, —nhe . 
suppresses printing of the name_list header. 


—no_participating, —npart 
lists only those users who are no longer participating. 


—no_read_only, -nro 
does not list read-only participants. 


-notify, -nt 
lists only participants with the notify flag on. 


-only_deleted, —odl 


a 4 2.) a 8 


-only_non_deleted, -ondl 
lists only information for participants who have not been deleted by the chairman. 
(Default) 


—participating, —part 
lists only users who are participating. (Default) 


-project Project_ids, —pj Project_ids 


lists only information about participants on the specified project. All arguments f ollowing 
—project until the next control argument are taken as Project_ids. 
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-tead_only, -ro 
lists just read-only participants. 


—seen transaction_number 
lists only participants who have read the specified transaction. 


~sort TYPE 
sorts the output by TYPE. TYPE is either "name" for sorting by the Person_id of 
participants, or “date_time_attended” (dta) for sorting by the time the participant last 
attended the meeting. This control argument can not be used for the active function. 


-totals, —tt 
prints only the total number of participants selected. 


unseen transaction_number 
lists only participants who have not read the specified transaction. 


-user Person_ids 
prints only information about the named participants. All arguments following —user until 
the next control argument are taken as Person_ids. 


NOTES 


The displayed flags have the following meanings: 


r the participant has been removed from the meeting and is therefore no longer 
a participant. 

n the user has the notify flag turned on. 

o the user is an observer and cannot enter transactions. 
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forum_refuse_notifications forum_refuse_notifications 


Name: forum__refuse_notifications, frnt 
SYNTAX AS A COMMAND 

frnt 

FUNCTION 


disables reception of interactive messages notifying the user of new transactions being entered 
in meetings. 
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forum_remove_meeting forum_remove_meeting 


Name: forum__remove_meeting, frm 

SYNTAX AS A COMMAND 

frm 

FUNCTION 

Temoves meetings in the user’s "forum" search list by deleting links to them from the 
directory >udd>Project>Person>meetings. 


ARGUMENTS 


meeting names 
are names of forum meetings to be removed from the search list. The star 
convention is allowed. 


CONTROL ARGUMENTS 


—check, -ck | . 
lists all links to meeting in >udd>Project>Person>meetings that point to non-existent 
meetings. Incompatible with —cleanup. 


~cleanup 
removes all links to forum meetings from >udd>Project>Person>meetings that point 
tO non-existent meetings. Incompatible with —check. 


—-directory PATH, -dr PATH 
removes the links from the specified directory instead of the default directory of 
>udd>Project>Person>meetings. 


NOTES 


If a meeting is found through some other entry in the "forum" search list, the site’s 
central forum directory for instance, this command cannot remove it. 
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SECTION 9 
DUTIES OF THE CHAIRMAN 


This section shows how to create and maintain meetings. For detailed descriptions of 
the chairman’s commands referred to here, see Section 10. 


CREATING A MEETING 

To create a meeting, use the forum_create (fcr) command. Forum asks you for all the 
necessary information, step by step. In the following example, assume that the user named 
Fox on the ProjA project wants to create a meeting in her working directory and that she 
wants it to be a public meeting. 


! fer 


Enter pathname of meeting directory (carriage return for 


working dir): 1 <CR> 

Please enter long meeting name (<20 characters): ! home_computers 
Now apts abbreviated meeting name: ! he 

Should the meeting be public? ! yes 

Do you want to enter a chairman message (? for explanation)? ! yes 
Message: 


! Welcome to the home_computers meeting. 
j ° 
The home_computers meeting has been established in >udd>ProjA>Fox. 
You must now enter the first transaction in the home_computers meeting, 
which will act as as an introduction. 
The meeting is public. Welcome to the home_computers meeting. 
Transaction: 
! This meeting is designed to allow anyone interested in personal 
! computing to discuss any issues related to such. Participants are 
! asked toe indicate which home computer they have. 
! 


wea 


Do you want to announce this meeting? !yes 
Enter the name of the meeting where the announcement should be made. 
Enter carriage return for >site>forum_dir>Meetings Directory 
! <CR> 
Please enter a short description of the access to the meeting. 
! This meeting is open to the public. 


r 10:30 2.096 87 


Transaction [0001] entered in >udd>ProjA>Fox>home_com 
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Now, if you reenter Forum and go to the home_computers meeting, Forum tells you 
that you are the chairman. The subject is automatically added to the first transaction since 
the first transaction is always the introduction. 


! forum he 

home_computers meeting: O new, 1 last (You are the chairman). 
forum: ! p 1 

[0001] (4 lines) Fox.ProjA 04/28/82 1030.2 est Wed eve 
Subject: Reason for this meeting 

<same text as shown in above example> 

---[0001]--- 


If you decide that you want to invite private participation only, you can specify exactly 
who can attend. When Forum asks whether the meeting should be public, simply reply no. 
Forum then offers to let you name individuals and/or whole projects as eligible participants. 
Individuals are specified by their Person_ids, and projects are specified by their Project_ids. 
The example below illustrates the questions asked by Forum. This sample meeting is created 
by Fox and is named basic_problems (basprob). 


Should the meeting be public? ! no 
Should specified individuals be allowed to participate? ! yes 


Now please type Person_ids of attendees when prompted. 
Signal the end of the list by typing a period only. 


Person_id: ! Montgomery 
Person_id: ! Manselle 
Person_id: ! 


Should specified projects be allowed to participate? ! yes 


Now please type Project_ids when prompted. 
Signal the end of the list by typing a period only. 


Project_id: ! ProjaA 
Project_id: ! ProjB 
Project_id: r. 


Person_ids and Project_ids are entered in a list, each followed by a carriage return 
(RETURN). When your list is complete, type a "." on a line by itself. 


| Now that you have selected the possible eligible participants, you are prompted for the 
| chairman’s message, and the meeting is established. After you enter the first transaction, you 
| are asked if you want to announce this meeting and you enter the name of the meeting 
| where the announcement should be made. You are then asked to enter a short description of 
| the access to the meeting. 
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Do you want to enter a chairman message (? for explanation)? ! yes 
pee ages 
! This is a developmental meeting 
! open to engineers only. 
ae 
The basic_problems meeting has been established in >udd>ProjA>Fox. 
You must now enter the first transaction in the basic_problems 
meeting, which will act as an introduction 
This is a developmental meeting open to engineers only. 
Transaction: 
! <transaction text> 
ae 
Transaction [0001] entered in >udd>ProjA>Fox>basic_problems meeting. 
Do you want to announce this meeting? ! yes 
Enter the name of the meeting where the announcement should be made. 
Enter carriage return for >site>forum_dir>Meetings Directory 
! <CR> 
Please enter a short description of the access to the meeting. 
! This meeting is open to the public. 


r 10:30 2.096 87 


MAINTAINING A MEETING 


As chairman, you can adjust the list of users who are eligible to participate in your 
meeting, adding and deleting users and projects as necessary at any time. The -read_only 
control argument to the forum_add_participant and forum_add_project commands (described 
below) lets you specify that certain users and/or groups of users be allowed only to read 
transactions, not to enter them. 


You also have the right to use certain Forum requests to delete offensive or irrelevant 
transactions, giving proper notice to the participants, and to retrieve transactions. 


As chairman, whether you created the meeting or inherited the chairmanship, you alone 
have the right to alter any aspects of the meeting. 


Adding a Participant 


It is simple to add a participant to the list of users who are eligible to attend your 
meeting. The f orum _add_participant (f apt) command adds users to the list, one at a time. To 


wwe 


added to your search rules, type: 
! fapt home_computer White 


White added to the home_computer meeting. 
r 08:42 0.247 66 
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To change the access of a participant to read only, use the forum_add_participant (fapt) 
command with the -read_only (ro) control argument to add the participant again. This 
changes the original access of the participant to read only. (See the forum_add_participant 
command later in the manual.) 


Adding a Project 


Adding a project name to your list of eligible participants is done the same way as 
adding a user, only with the forum_add_project (fapj) command. (You can only add one 
project at a time.) The example below shows two projects being added to the list of eligible 
participants. 


! fapj home_computer ProjB 

ProjB added to the home_computer meeting. 
r 08:53 0.290 66 

! fapj home_computer Engr 

Engr added to the home_computer meeting. 


r 08:54 0.187 66 


To change the access of a project to read only, use the forum_add_project -(fapj) 
command with the -read_only (ro) control argument to add the project again. This changes 
the original access to allow users on the project to read transactions but not enter them. (See 
the forum_add_project (fapj) command later in this manual.) 


Making a Meeting Public 


The forum_make_public (fmp) command opens a meeting to public participation, thereby 
overriding any explicit eligibility requirements that may have previously been set. You can, 
however, remove participants and  opprojects from a _ public meeting with the 
forum_remove_participant and forum_remove_project commands (described beiow). 

i fmp home_computer 


Meeting home_computer is now public. 


r 08:57 0.319 1 


Making a Meeting Private 


Suppose you want to make a previously public meeting private and deny participation 
rights to an individual or a project. 
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The forum_unmake_public (fump) command makes a formerly public meeting into a 
private one. 


! fump home_computer 
Meeting home_computer is no jonger public. 


r 08:06 0.215 63 


Now that the meeting is private, you must explicitly make users eligible to attend, or 
no one will be able to. Use the forum_add_participant and forum_add_project commands as 
shown above. 


Removing a Participant 


Three levels of removal (access denial, logical removal, and physical removal) allow you 
to bar participants in degrees of permanency. 


On the top level, you can deny access to a meeting for a participant with the 
forum_remove_participant (frpt) command. This command removes the user’s record of 
participation or attendee record (showing User_id, last time attended, and last transaction 
seen) from the list of participants that the "list_users" request normally displays. Any user 
can, however, see the names of removed participants by using the "“list_users -all" request, 
which includes in its display removed participants (indicated by the "r" flag). 


To remove a participant f rom the list of eligible participants, use the forum_remove_participant 
(frpt) command: 


! frpt home_computer White 
White has been removed from the home_computer meeting. 


r 08:10 0.347 86 


You can go one step further and logically remove (i.e., conceal from public view) that 
user’s record of participation in your meeting with the “delete_participant” request. 


forum: ! dlpt White 


When you issue this request, Forum does not print an acknowledgment--the participant is 
simply removed. Now the user’s record of participation is invisible to everyone but the 
chairman. You can still change your mind and retrieve the record with "retrieve_participant”, 
which replaces that user’s record in the list of users. 


To physically (and finally) remove a participant’s record, use the "expunge" request 
which physically removes all deleted participants from a meeting. Note that participants to be 
expunged must first be deleted with the delete_participant request. 
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forum: ! expunge -participants 

forum (expunge): Expunging the meeting will destroy aii records 
of deleted participants. Do you really want to expunge the 
home_computer meeting? ! yes 

4 participants expunged. 


forum: 


This request allows you to reclaim space and save your quota. This is necessary if 
your meeting is too big and in danger of running out of storage space (approaching 
the limit of 500 attendees.) The "expunge" request also validates the internal structure 
of the meeting and deletes damaged items, but it is time-consuming and generally only 
done to save a meeting. 


Removing a Project 


To remove a Project_id from the eligible list, use the forum_remove_project 
(frpj) command: 


! frpj home_computer ProjB 
Project ProjB removed from home_computer meeting. 
r 08:14 0.421 86 


Maintaining Meeting Access 


If a meeting was created with the MR11 (or later) version of forum, you can 
use the standard access control list (ACL) commands (list_acl, set_acl, and delete_acl). 
You can use these commands to add participants or projects to the list of users who 
are eligible to attend your meeting. You can also use these commands to deny 
members rights to a meeting or to limit participants to read only status. Additionally, 
you can use these commands to remove a project from the eligible list. 


If you are not in the directory containing the meeting, you must include the full 
pathname of the meeting including the ".forum" suffix. If you are in the meeting 
directory containing the meeting, you only need to include the name of the meeting 
and the ".forum" suffix. 


To add a participant to the list of users who are eligible to attend your meeting, 
you can use the set_acl command. This command is equivalent to the forum_add_participant 
command and adds users to the list one at a time. If you are in the directory 
containing the accounting meeting and you want to allow the user McElvenny to 
attend the accounting meeting, type: 


! set_acl accounting.forum rw McElvenny 


r 0.8:42 0.246 66 
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To allow the public read transactions in a meeting but not enter them, you can use the 
set_acl command with r.* status. This command line is equivalent to the forum_make public 
command used with the -read_only control argument. If you are in the directory containing 
the accounting meeting and want to allow the public to read transactions in the accounting 
meeting, but not enter them, type: 


! set_acl accounting .forum r.* 


To remove a Project_id from the eligible list, you can use the set_acl command with 
nuii status. This command line is equivalent to the forum_remove_project (frpj) command. If 
you are in the directory containing the budget meeting and want to remove the Marketing 
project from the budget meeting, type: 


i set_acl budget.forum null *.Marketing 


r 0:42 0246 66 


Deleting Transactions 


Occasionally you will need to delete transactions. As chairman, you have the power to 
remove offensive or irrelevant transactions. Two levels of deletion (logical removal and 
physical removal) allow you to remove transactions in degrees of permanency. First, the 
Forum "delete" (dl) request logically removes specified transactions from a meeting. You can 
delete a range of transactions, if necessary. In the example below, the chairman deletes the 


tra t 
transact 


attassrin ome anton 


ain o~ ha = 
n while attending the meeting: 


ion whi 
forum: ! dl 7 


forum: 


After Forum deletes the transaction, it puts you back into the request loop. Thereafter, when 


any attendee attempts to specify the deleted transaction, Forum answers that the transaction 
has been deleted. 


forum: ! Is 7 
forum (list): The specified transaction has been deleted. Transaction 7. 
forum (list): No transactions were selected. 


forum: 


The first Forum message in the above example explains that transaction 7 has been deleted 
and will therefore not be found by the “list” request. Since no transactions other than 
transaction 7 were specified in the request line, the "list" request has not selected any 
transactions and therefore printed the second message. If the request had specified two 
transactions (e.g., "Is 7:8"), Forum would have listed only transaction 8. 


Remember that position 7 in the proceedings is permanently filled, even though the 
transaction has been deleted. The next transaction entered is numbered 8, and transaction 7, 
although it no longer appears in the proceedings, is saved elsewhere and can be retrieved at 
any time with the "retrieve" request (see below). 
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forum: ! Is 1:8 


Trans# ‘Lines Date Time Author Subject 

[0001] (5) 05/18/81 03:20 Brooks.ProjA Reason for this meeting 
[0002] (3) 05/20/81 03:46 Davis.YAK Fortran for a Begi<More> 
[0003] (3) 05/21/81 06:49 Smith.ProjB Other Meetings 

[0004] ‘* 

[0005] 

[0006] P 

[0008] : 

forum: 


Notice that there is no transaction [0007] listed. As chairman, you usually enter another 
transaction yourself to explain the disappearance of other transactions, explaining why the 
deletion was necessary. 


Second, to physically (and finally} remove deleted transactions from the meeting, use the 
“expunge” request: 


forum: ! expunge -transactions 

forum (expunge: Expunging the meeting will destroy all records 
of deleted transactions. Do you really want to expunge the 
home_computer meeting? ! yes 

6 transactions expunged. 


forum: 


Note again that only deleted transactions can be expunged. 


Retrieving Participants and Transactions 


The "retrieve_participant" (rtpt) request retrieves a user’s record of participation after 
you have deleted that record with the “delete_participant" request. The user’s record of 
participation is restored to the list of the meeting’s participants. 
forum: ! rtpt Black 


forum: 


The "retrieve" (rt) request retrieves transactions that you have previously removed from 
the proceedings. You can retrieve a range of transactions, if necessary, but regular expressions 
and Person_ids can not be used as transaction specifiers with this request. To print a list of 
the deleted transactions in the current meeting, type “list -only_deleted". To retrieve 
transaction [0007], type: 


forum: ! rt 7 


forum: 


Now when you list the proceedings of the meeting, transaction [0007] appears in its original 
slot in the list and has been restored in its entirety to the meeting. 
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Setting a Message 


The "set_message" request allows you to enter a message that is printed each time a 
user enters the meeting or enters a transaction from elsewhere within Forum. You can also 
use this request to change the message that you have previously set. Some messages set by 
chairmen are greetings ("Welcome to the Television meeting") while other messages describe 
restrictions or warnings ("This is a developmental meeting open to Honeywell employees 
only"). The message has a maximum allowable size of 256 characters. 


Enter the meeting that you want to set a message in. If you have already entered the 
message into a segment, use the "—input_file pathname" control argument with "set_message" 
to set the message that is contained in that segment. Otherwise, type only “set_message”, and 
Forum prompts you for the message, which you must end in one of the ways described for 
exiting from terminal input mode. 


If you have written your message into a segment named “greeting” you would set the 
message this way (assume that you are already attending the Television meeting): 


forum: ! set_message -if greeting 
Use the "enter'' request to enter the message. 


forum: ! enter 
forum: 


The message has been set. 


Suppose you want to build the message from within Forum: 


forum: ! set_message 

Message: 

! Welcome to the Television meeting. 

! This meeting is for discussing and rating 
! television shows shown at prime-time. 

! Please try to be as brief as possible. 

! 


forum: 


Again, the message has been set. 


Printing Eligibility Messages 

The eligibility message for a meeting, as shown in Section 2, greets the user upon 
entrance to the meeting. Site administrators decide whether or not these messages are globally 
printed for all meetings on the system. If site administration turns them on globally, you 
(the chairman) can then either go along with the system-wide printing of these messages or 
turn printing off for the meeting that you chair. 
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The "switch_on" (swn) and "switch_off" (swf) requests accept the switchname 
"meeting_eligibility_messages" (mtg_emsg). To turn off printing of the message (only if your 
site administration has turned printing on), type: 


! swf mig _emsg 


forum: 
To turn printing back on, type: 


forum: ! swn mtg_emsg 


NAMING A NEW CHAIRMAN 


The chairman-of-record is the person who originally created the meeting. If you are 
the current chairman, you can use the “chairman” (cm) request with the -set control argument 
to change the chairman of the current meeting. Only the current chairman is allowed to pass 
on the chairmanship of the meeting to someone else. The new chairman must be specified by 
his/her Person_id.Project_id. To change the chairman of the Accounting meeting (the current 
meeting) type: 


forum: ! cm -set BMcElvenny.ProjA 


forum (chairman): Do you really want to change the chairman of the 
Accounting meeting to BMcElvenny.ProjA ! yes 


forum: 


ADDING A CHAIRMAN 


Meetings created with the MR11 (or later) version of forum can have more than one 
chairman. The chairman-of-record is the person who originally created the meeting and the 
one whose name is returned by the chairman request. 


To add an additional chairman to a meeting, use the forum_add_particiapnt (fapt) 
command with the -chairman control argument. This allows the added participant to have 
chairman access to the meeting. To add. the participant McElvenny and give him chairman 
access to the Accounting meeting, type: 


forum: ! fapt Accounting McElvenny -chairman 
McElvenny added to the Accounting meeting with chairman access 


r 08:42 0.247 66 
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You can also use the set_acl command to add an additional chairman to a meeting: 


forum: ! set_acl Accounting.forum rwc McElvenny 


Additionally, you can use the fapt or the set_acl command to give a whole project chairman 
access. 


DELETING A MEETING 


If the reason for your meeting was a question that has been resolved, or was to discuss 
and prepare for an event that is now over, or in any event is no longer valid, you will want 
to delete your meeting. Of course you will want to give reasonable notification to the 
participants of the meeting, perhaps through a transaction or by setting a message. The 
forum_delete (fdl) command deletes a meeting: 


! fdl home_computers 
r 08:23 0.307 2 


PRE-MR11 FORUM MEETINGS AND CURRENT VERSION FORUM MEETINGS 


A forum meeting created with pre-MR11 software consists of two storage system 
segments which contain records of the participants in the meeting and what has been said. 
These meetings contain the suffixes “.control" or "“.proceedings". A current version forum 
meeting (MR11 or later) is created as a single segment with the suffix ".forum". The current 
version forum software supports both pre~MR11 forum meetings and current version forum 
meetings. - . 


The meetings created with current version forum software are treated as entries within 
the Multics storage system. Since current version forum meetings are treated as such, you can 
use the standard file system commands such as copy, delete, list_acl, and set_acl. This support 
also alleviates limitations on the number of meeting attendees and transactions. Current 
version meetings have no easily relizable limit on the amount of information which they can 
contain. 


The current version forum also incorporates a new search strategy for locating forum 
meetings by looking in the forum list to find the meetings. Additionally, the current version 
forum meetings provide a "seen" flag for each transaction (in contrast with a pre-MRI11 
meeting which only sets a single flag for the most recent transaction seen). 
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CONVERTING A MEETING 


previously). 


Each site has been supplied with tools which will convert all pre-MR11 meetings to 
current version meetings. If your site decides not to use these tools, each individual chairman 
can convert the pre-MR11 meetings to current version meetings. The convert_forum command 
(described in Section 10) converts a pre-MR11 meeting into a current version forum meeting. 
Only the chairman of the meeting can use this command. 


To ensure a smooth transition for meeting users, the chairman should perform the 
following actions before using the convert_forum command: 


Le Enter a transaction for meeting users explaining that the meeting will be 
converted to a current version meeting and all participants should use the 
"add_meeting_ update" request (described in Section 7) to update their forum 
search list. 


2. To prevent participants from entering any more transactions in the old meeting, 
you should use the add_participant, add_project or make_public request with 
the read_only control argument. 


3... Once you have created the current version meeting with the convert_forum 
command, you should delete the old meeting using the forum_delete command 
described in Section 8. To avoid deleting the current version meeting you must 
use the suffix ".control" after the meeting name. 
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SECTION 10 
CHAIRMAN COMMANDS 


The commands in this section are intended to be used only by the chairman, or 


maintainer, of the meeting. (For a step-by-step breakdown of the duties of a chairman, see 
Section 9.) 


The descriptions of the Forum administrative commands are presented here in 
alphabetical order. Each description contains the name of the command (including the 
abbreviated form, if any), discusses the purpose of the command, and shows the correct 
usage. Notes and examples are included when deemed necessary for clarity. 
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forum_add_ participant forum_add_participant 


Name: forum__add_ participant, fapt 

SYNTAX AS A COMMAND 

fapt meeting_name Person_id {-control_args} 
FUNCTION 


makes the person identified by Person_id eligible to attend the meeting_name meeting. You 
can use this request if you have either modify permision on the containing directory or 
chairman access to the meeting. 


ARGUMENTS 


meeting name 
is the pathname or entryname of the meeting to be adjusted. Pathnames contain 
greater-than (>) or less-than (<) characters. If a pathname is specified, it identifies the 
meeting to be adjusted. Otherwise, fapt searches for the meeting_name by using the 
forum search list. 


Person_id 
is the Person_id of the participant to be added. 


CONTROL ARGUMENTS 


~chairman, —cm 
gives chairman access to the added participant. This control argument is not valid for 
meetings created with pre-MR11 software. 


~tead_only, -ro 
allows the added participant to read transactions but not enter them. 


NOTES 
The -read_only and -chairman control arguments cannot both be specified. 


To change the access of a participant to read only, use the fapt command with the 
-read_only control argument to add the participant again. This will change the original access 
of the participant to read only. 


The meeting chairman can use the convert_forum command (described in “Chairman 
Commands" in this manual) to convert meetings created with pre-MR11 software to current 
version meetings. The old version meeting is left untouched and should be deleted using the 
forum_delete command (described in "User Commands" in this manual). To avoid deleting the 
current version meeting, you must include the “control” suffix at the end of. the 
meeting_name. 
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forum_add_ project forum_add_ project 


Name: forum__add_ project, fapj 

SYNTAX AS A COMMAND 

fapj meeting_name Project_id {-control_args} 
FUNCTION 


makes users from the project identified by Project_id eligible to attend the meeting_name 
meeting. 


ARGUMENTS 


meeting name 
is the pathname or eniryname of the meeting to be adjusted. Pathnames coniain 
greater-than (>) or less-than (<) characters. If a pathname is specified, it identifies the 
meeting to be adjusted. Otherwise, fapj searches for the meeting _name by using the 
forum search list. 


Project_id 
is the Project_id for the project to be admitted to the meeting. 


CONTROL ARGUMENTS 

-chairman, -cm 
gives chairman access to the added participant. This control argument is not valid for 
meetings created with pre-MR11 software. 


-read_only, -ro 
allows users on the added project to read transactions but not enter them. 


ACCESS REQUIRED 


You can use this request if you have either modify permision on the containing directory or 
chairman access to the meeting. 


NOTES 
The -read_only and -chairman control arguments cannot both be specified. 
To change the access of a project to read only, use the fapi command with the -read_only 


control argument to add the project again. This changes the original access to allow users on 
the project to read transacrions but not enter them. 
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forum_create forum_create 


Name: forum__create, fcr 
SYNTAX AS A COMMAND 


fer 
FUNCTION 
creates a new meeting with the user as chairman. It engages the user in a dialogue, 


prompting for all information necessary for the creation of a new meeting including long and 
short meeting names, participant information, and the first transaction in the meeting. 


NOTES 


See "Duties of the Chairman" in this manual for a detailed discussion, including a complete 
example showing the creation of a meeting with this command. 7s 
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forum_make_public forum_make_public 


Name: forum__make_ public, fmp 

SYNTAX AS A COMMAND 

fmp meeting_name {control_args} 

FUNCTION 

opens the meeting name meeting to public participation. 

ARGUMENTS 

meeting_name 
is the pathname or entryname of the meeting to be made public. Pathnames contain 
greater-than (>) or less-than (<) characters. if a pathname is specified, it identifies the 
meeting to be made public. Otherwise, fmp searches for the meeting_name by using the 
forum search list. 

CONTROL ARGUMENTS 

-chairman, -cm 
gives chairman access to the added participant. This control argument is not valid for 


meetings created with pre-MR11 software. 


-read_only, -ro 
allows the public to read transactions but not enter them. 


ACCESS REQUIRED 


You can use this request if you have either modify permision on the containing directory or 
chairman access to the meeting. 


NOTES 


The ~read_only and -chairman control arguments cannot both be specified. 
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forum_remove_participant forum_remove_participant 


Name: forum__remove__participant, frpt 
SYNTAX AS A COMMAND 

frpt meeting _name Person_id 
FUNCTION 


makes the person identified by Person_id ineligible to attend the meeting_name meeting. 


ARGUMENTS 


meeting_name 
is the pathname or entryname of the meeting to be adjusted. Pathnames contain 
greater-than (>) or less-than (<) characters. If a pathname is specified, it identifies the 
meeting to be adjusted. Otherwise, frpt searches for the meeting_name by using the 
forum search list. 


Person_id 
is the Person_id of the user to be removed from participation in the meeting. 


ACCESS REQU/RED 


You can use this request if you have either modify permision on the containing directory or 
chairman access to the meeting. 


NOTES 


The -read_only and -chairman control argumenis cannot both be specified. 
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forum_remove_project forum_remove_project 


Name: forum_remove__project, frpj 
SYNTAX AS A COMMAND 

frpj meeting_name Project_id 
FUNCTION 


denies eligibility to all participants who are currently eligible to attend by virtue of their 
project participation alone (not by virtue of their Person_id) from the meeting_name meeting. 


ARGUMENTS 


meeting_ name 
is the pathname or eniryname of the meeting to be adjusted. Pathnames contain 
greater-than (>) or less-than (<) characters. If a pathname is specified, it identifies the 
meeting to be adjusted. Otherwise, frpj searches for the meeting_name by Using the 
forum search list. 


Project_id 
is the Project_id of the project whose members are to be denied participation rights if 
they lack explicit Person_id participation rights. 


ACCESS REQUIRED 


You can use this request if you have either modify permision on the containing directory or | 
chairman access to the meeting. 
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forum_unmake_public forum_unmake_public 


— 1. 


Name: forum unimake__pubiic, fump 
SYNTAX AS A COMMAND 

fump meeting _name 

FUNCTION 


removes all participants from the meeting_name meeting who are participating by virtue of 
the public attribute. All users who are not participating because of Project_id or Person_id 
Tights are removed. 


ARGUMENTS 


meeting_name 
is the pathname or entryname of the meeting to be adjusted. Pathnames contain 
greater-than (>) or less-than (<) characters. If a pathname is specified, it identifies the 
meeting to be adjusted. Otherwise, fump searches for the meeting_name by using the 
forum search list. 


ACCESS REQUIRED 


| You can use this request if you have either modify permision on the containing directory or 
| chairman access to the meeting. 
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convert_forum convert_forum 


Name: convert__forum 
SYNTAX AS A COMMAND 
convert_forum meeting_name 
FUNCTION 


converts a pre-MR11 forum meeting to a current version forum meeting. The current version 
meeting is created in the same directory as the original meeting. All addnames and the access 
control list are copied. The convert_forum command does not delete the pre-MR11 meeting. 


ARGUMENTS 


—-meeting_name 
is the pathname or entryname of the meeting to be converted. Pathnames contain 
greater-than (>), or less-than (<) characters. If a pathname is specified, it identifies the 
meeting to be converted. Otherwise, the convert_forum searches for the meeting name by 
using the forum search list. 


ACCESS REQUIRED 


Only the chairman of the meeting can use this command. 
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APPENDIX A 
ADMINISTRATIVE INFORMATION 


System administrators can change the attributes of any meeting by the use of the 
forum_admin command. The forum_admin command provides the necessary administrative 
backup in the event a chairman is no longer able to function in that capacity, as well as the 
ability to determine system-wide policies regarding optional Forum features. 


In order to use Forum at a site, you must do a few things other than install the 
software and associated info segments. The central meeting directory and notifications database 
must be created, and there are several "customizing" features regarding access control that a 
site may want to change. 


INSTALLATION INSTRUCTIONS 


' The Central Forum Directory 


This directory is the repository for public site-approved meetings. It is known to the 
forum so ftware 4 ult "forum" search path. The pathname of the directory is 
>site>forum_dir. This directory should be created and given an ACL term of "s *.*.#" along 
with the "sma" ACL terms given to administrators entrusted with creating meetings there. — 


If for some reason, a site wishes to use some other directory as the central directory, 
the following steps should be taken: 


ie Change the assignment of forum_external_data.central_directory in the segment 
forum_data_.cds to the desired path and recompile it. 


2; Initiate the new copy of forum_data_ and _ fecompile the segment 
forum_search_list_default_.cds in bound_forum_.s.archive 


3. Update forum_search_list_default_ in bound_forum_.archive and _ rebind 
; bound_forum_. 


Install the new source/obdjeci/executable versions of bound_forum_ and 
forum_data_. 


- 
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The Site Meeting Directory 


_ This directory is a public meeting where users can place announcements about meetings 
of general interest. It is located in the central forum directory and the pathname is 
>site>forum_dir>Meetings_Direciory (this is the default and other pathnames are possible). 
The forum_create command and announce_meeting request both place meeting announcements 
in this meeting by default. 


Forum looks for a pre-MR11 version meeting named Meetings_Directory.control. If 
your site has a public meeting of this type, but the meeting has a different name, you must 
update the forum_data_.cds segment by changing the assignment of the variable 
forum_external_data.meetings_directory. You can then recompile and install the new forum_data_. 
with the correct suffix (control for a pre-MR11 version meeting and .forum for a current 
version meeting). You must also follow the above steps if you convert your public meeting 
from a pre-MRI11 version meeting to a current version meeting or if you are a new site 
creating the meeting for the first time. 


The Notifications Database 


The Forum subsystem maintains a database of users who are currently accepting 
notifications of new transactions (see Section 4 for an explanation of notifications). This 
segment resides in the central forum directory and must be created before notifications can 
be used. An administrator who has access to the forum_admin_ gate should create this 
segment with the command: 


! forum_admin init_notifications 


(See the "Gate Access" below for information on the forum_admin_ gate.) 


Gate Access 


The Forum subsystem has two gates: forum_ and forum_admin_. The forum_ gate is 
essential to use the subsytem and should have its access set to “re *.¥*,*". 


The forum_admin_ gate is used to perform administrative functions for Forum and to 
perform chairman functions on meetings (such as changing access and changing the chairman) 
by users other than the chairman of those meetings. This is a highly-privileged gate. The 
default access to this gate is “re *.SysMaint.* null *.*.*". 
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Eligibility Messages 


In order to keep participants informed of the audience of a particular meeting, Forum 
provides an optional facility that tells participants how many projects and users may read a 
meeting, and warns the participant each time the access to the meeting changes. The chairman 
of the meeting normally invokes this facility, but it can be manipulated by users with access 
to the forum_admin_ gate as follows. The command: 


! forum_admin switch_on print_eligibility_messages 


will cause Forum to print eligibility messages for every meeting on the system unless 
specifically exempted by the following two switches. 


The command: 
! forum_admin switch_on chairman_set_eligibility_msgs 


allows the chairman to turn eligibility messages off even if the print_eligibility_messages 
switch is on, and the command: 


! forum_admin switch_(on off) meeting_eligibility messages PATH 


will turn eligibility messages for the meeting identified by PATH on or off regardless of the 
setting of the system-wide switches. 


AIM 

Forum is a singie-class AIM facility. Meetings are single-class storage system objects. 
All participants must be logged in at the same authorization, which must be the access class 
of the meeting. Different meetings, however, may be at different access classes. The access 
class of a meeting is the authorization of the chairman at the time the meeting was created. 
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forum_admin forum_admin 


SYNTAX AS A COMMAND 
forum_admin key {arguments} 
FUNCTION 


allows system administrators to change attributes of meetings that they do not chair. This 
command is also used to perform certain administrative functions such as initializing the 
forum notifications database. 


ARGUMENTS 


key 
is any key described below in “List of Keys.” 


arguments 
are the arguments for individual Keys described below. 


LIST OF KEYS 


change_chairman path new_chairman 
displays the User_id of the current chairman of the meeting whose pathname is “path” 
and then shifts the chairmanship to new_chairman. new_chairman must be of the form 
Person_id.Project_id. j 


convert path 
converts the meeting whose pathname is "path" from a pre-MRI11 Version meeting to a 
current version meeting. 


delete path 
deletes the meeting whose pathname is "path". 


init_notifications 
creates an empty notifications database segment in the central forum directory. 


switch_off switchname, swf switchname 
turns the specified switch off. See "List of Switches” below. 


switch_on switchname, swn switchname 
turns the specified switch on. See "List of Switches” below. 
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forum_admin forum_admin 


LIST OF SWITCHES 


adjourned path, adj path 


temporarily adjourns the meeting specified by path. When this switch is on, no users 
may enter the meeting. 


chairman_set_eligibility_msg, cm_set_emsg 
allows the chairman to override the print_eligibility_messages switch. 


meeting_eligibility_messages path, mtg_emsg path 
turns on eligibility messages for the meeting named by "path". 


print_eligibility_messages, pemsg 
turns on eligibility messages for all meetings on the system. 


ACCESS REQUIRED 


This command requires access to the forum_admin_ gate. In addition, the convert, delete, and 
access-changing keys require at least "m" access to the directory containing the meeting, as 
does setting a switch on a meeting if access must be forced. Setting global switches requires 
"rw" access to forum_data_, and the init_notifications key requires "sma" access to the central 
forum directory. 
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APPENDIX B 
SUBROUTINE DESCRIPTIONS 
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forum_ 


The forum_ subroutine provides a subroutine interface to the Forum interactive meeting 


system. 


Entry: forum_$accept_notifications 

This entry turns on reception of forum notifications by the calling process. 
USAGE 

declare forum Saccept_notifications entry (fixed bin(35)); 
call forum _Saccept_notifications (status) ; 

ARGUMENTS 


Status 
is a standard status code. (Output) It can have the following value: 


forum_error_table_$no_notify_seg 
The notifications database could not be initiated. 
Entry: forum_$change_chairman 
This entry is used to change the chairman of a Forum meeting. 
USAGE 


declare forum_S$change_chairman entry (char (*), char (*), char (*), fixed 


bin(35)); 
call forum_Schange_chairman (dirname, entryname, chairman, status) ; 
ARGUMENTS 


dirname 
is the pathname of the directory containing the meeting. (Input) 


entryname 
is the name of the meeting. The ".forum" suffix is required. (Input) 


chairman 


is the name of the new chairman of the meeting, in the form Person.Project. The new 


chairman must already be a participant. (Input) 


forum_ forum_ 


status 
is a standard status code. (Output) It can have one of the following values: 


forum_error_table_$chairman_only 
The caller is not the current chairman. 


forum_error_table_$no_such_user 
The supplied new chairman is not a participant. 
Entry: forum_$change_chairman_ idx 


This entry changes the chairman of a Forum meeting. It is the same as the change_chairman 
entry point except that a forum_idx is used to identify the meeting instead of a pathname. 


USAGE 


declare forum_Schange_chairman_idx entry (fixed bin, char (*), 
fixed bin(35)); 


call forum_Schange_chairman_idx (forum_idx, chairman, status) ; 
ARGUMENTS 


forum_idx 
identifies a meeting opened by forum_$open_forum. (Input) 


chairman 
is the name of the new chairman of the meeting, in the form Person.Project. The new 
chairman must already be a participant. (Input) 


status 
is a standard status code. (Output) It can have one of the following values: 


forum_error_table_$chairman_only 
The caller is not the current chairman. 


forum_error_table_$no_such_user 
The supplied new chairman is not a participant. 
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forum_ forum_ 


Entry: forum __$chname__ forum 
This entry is used to change the names of Forum meetings. 
USAGE 


declare forum_Schname_forum entry (char (*), char (*), char (*), char (*), fixed 


bin (35))s 
call forum_Schname_forum (dirname, entryname, old_name, new_name, status) ; 
ARGUMENTS 


dirname 
is the pathname of the directory containing the meeting. (Input) 


entryname 
is the name of the meeting. The ".forum" suffix is required. (Input) 
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forum_ forum_ 


old_name 
is a name to be removed from the meeting, or blank if no name is to be removed. If 
non-blank, ".forum" suffix is required. (Input) 


new_name 
is a name to be added to the meeting, or blank if no name is to be added. If 
non~blank, the ".forum"” suffix is required. (Input) 


Status 
is a standard status code. (Output) 


Entry: forum_$chname__forum__idx 
This entry is used to change the names of Forum meetings. It is the same as the 


chname_forum entry point except that a forum_idx is used to identify the meeting instead of 
a pathname. 


USAGE 

declare forum_$chname_forum_idx entry (fixed bin, char (*), char (*), fixed 
bin (35)) ; | 

call forum_$chname_forum_idx (forum_idx, old_name, new_name, status); 

ARGUMENTS 

forum_idx 


identifies a meeting opened by forum_$open_forum. (Input) 


old_ name 
is a name to be removed from the meeting, or blank if no name is to be removed. If 
non-blank, the ".forum" suffix is required. (Input) 


new_name 
is a name to be added to the meeting, or blank if no name is to be added. If 
non-blank, the ".forum" suffix is required. (Input) 


status 
is a standard status code. (Output) 
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forum_ forum_ 


Entry: forum__$create_ forum 

Creates a Forum meeting with the user as chairman. 

USAGE 

declare forum_Screate_forum entry (char (*), char (*), fixed bin(35)); 
call forum_Screate_forum (dirname, entryname, status) ; 

ARGUMENTS 


dirname 
is the pathname of the directory containing the meeting. (nput) 


entryname 
is the name of the meeting. The "“.forum" suffix is required. (Input) 


status 
is a standard status code. 


ACCESS REQUIRED 


The caller must have modify permission on the containing directory. 


Entry: forum_$set_vl__forum__acl 

This entry is valid only for meetings created with pre-MRI11 software. This entry is used to 
add or change an ACL term. ACL terms can only be specified for Person_id.* or 
*,.Project_id, terms of the form Person_id.Project_id are not allowed. 

USAGE 


declare forum_Sset_vl_forum_acl entry (fixed bin, char (*), bit(1) aligned, 
bit(1) aligned, bit(1) aligned, fixed bin(35)); 


call forum_Sset_v!_forum_acl (forum_idx, access_name, user_sw, set_sw, 
write_sw, status) ; 


ARGUMENTS 


forum_idx 
identifies a meeting opened by forum_$open_forum. (Input) 


access_name 


The Person_id or Project_id whose ACL is to be added or deleted. Access_name can not 
contain a ".". (Input) 
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user_Sw 


forum_ 


This switch should be on if access_name is a Person_id, and off if it is a Project_id. 


(Input) 


set_sw 


This switch should on if access is to be added, and off if it is to be deleted. (input) 


write_sw 


This switch should on if write access is to be added, and off if only read access is to 


be added. This switch is ignored if set_sw is off. (Input) 


Status 
is a standard status code. (Output) 


ACCESS REQUIRED 


The caller must have modify permission on the containing directory. 


Entry: forum_$vl_ expunge 


This entry is used to physically remove deleted participant records and deleted transactions 


from a Forum meeting. This results in reclaimed storage space. 


ao Ww ae ess, a er 8 Se 


USAGE 


declare forum_$vl_expunge entry (fixed bin, bit (36) aligned, fixed bin, fixed 


bin, fixed bin, fixed bin, fixed bin(35))3 


call forum_$vl_expunge (forum_idx, switches, users deleted, trans_deleted, 


users damaged, trans_damaged, status) ; 
ARGUMENTS 


forum_idx 
identifies a meeting opened by forum_$open_forum. (Input) 


switches 
is a word of switches as follows: (Input) 


transactions 
if set, deleted transactions should be expunged. 


users 
if set, deleted participant records should be expunged. 


users_deleted 
is the number of participant records which were expunged. (Output) 
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trans_deleted 
is the number of transactions which were expunged. (Output) 


users_damaged 


forum_ 


is the number of participant records which were expunged because they were inconsistent. 


(Output) 
trans_damaged 


is the number of transactions which were expunged because they were inconsistent. 


(Output) 
Status 
is a standard status code. (Output) 
Entry: forum__$check__user 
This entry is used to determine if a user is a participant in a Forum meeting. 
USAGE 


declare forum_Scheck_user entry (fixed bin, char (*), fixed bin, fixed 


bin (35)) 3 
call forum_Scheck_user (forum_idx, user_name, l]ast_entered, status) ; 
ARGUMENTS 


forum_idx 
identifies a meeting opened by forum_$open_forum. (Input) 


user_name 
The Person_id of the user to be checked. (Input) 


last_entered 


is the index of the most recent transaction entered by this user, or 0 if this user has 


never entered a transaction. (Output) 


Status 
is a standard status code. (Output) 
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Entry: forum__$close_ forum 

This entry closes a meeting opened by forum_$open_forum. 

USAGE 

dectare forum_Sclose_forum entry (fixed bin, fixed bin(35)); 

call forum_Sclose_forum (forum_idx, status) ; 

ARGUMENTS 

forum_idx 
identifies a meeting opened by forum_$open_forum. This argument will be set to zero if 
the meeting is successfully closed. (Input/Output) 


Status 
is a standard status code. It can have the following value: 


forum_error_table_$invalid_forum_idx 
forum_idx does not identify an open meeting. 

Entry: forum_S$convert 
This entry converts a meeting created with pre-MR11 software into . current version meeting. 
USAGE | 
declare forum Sconvert entry (char (*), char (*), fixed bin (35)); 
call forum_Sconvert (dirname, entryname, status) ; 
ARGUMENTS 


dirname 
is the name of the directory containing the meeting. (Input) 


entryname 
is the name of the meeting. (Input) The ".control" suffix is required. 


status 
is a Standard status code. 


ACCESS REQU/RED 


The caller must have modify permission on the containing directory and chairman access to 
the meeting. 
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Entry: forum_ $convert_ attendee__idx 
This entry is used to convert an attendee_idx into a user name. 
USAGE 


declare forum_Sconvert_attendee_idx entry (fixed bin, fixed bin, char (%), 
fixed bin(35))s 


call forum_Sconvert_attendee_idx (forum_idx, attendee_idx, user_name, status) ; 
ARGUMENTS 


forum_idx . 
identifies a meeting opened by forum_$open_forum. (Input) 

attendee_idx 
is the index of a participant in a meeting, as placed in Forum interprocess messages. 
(Input) 

user_name 
is the name of the user with the specified attendee_idx, in the form Person_id.Project_id. 
(Output) 


status 
is a standard status code. (Output) It can have the following value: 


forum_error_table_$invalid_attendee_idx | | 
The Supplied attendee index does not correspond to a valid participant record in this 
meeting. 

Entry: forum__$delete__forum 

Deletes a Forum meeting. 

USAGE 

declare forum _S$delete_forum entry (char (x), char (*), fixed bin(35)); 

call forum _$delete_ forum (dirname, entryname, status) ; 

ARGUMENTS 


dirname 
is the pathname of the directory containing the meeting. (Input) 


entryname 
is the name of the meeting. The ".forum" suffix is required. (Input) 
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Status 


is a standard status code. (Output) 


ACCESS REQUIRED 


The user must have modify permission on the containing directory. 


Entry: forum_ $delete_forum__acl 


forum_ 


This entry deletes specified entries from an access control list (ACL). This entry cannot be 
used on meetings created with pre-MR11 software. 


USAGE 


declare forum_S$delete_forum_ac! entry (char (*), char (*), ptr, fixed bin, fixed 


bin (35)); 


call forum_S$delete_forum_acl (dirname, entryname, acl_ptr, acl_count, code) ; 


ARGUMENTS 
dirname 
is the pathname of the directory containing the meeting. (Input) 
entryname 
is the name of the meeting. The ".forum" suffix is required. (Input) 
acl_ptr 
points to a user-filied delete_acl structure (see “Notes” below). (Input) 
acl_count 
is the number of ACL entries in the delete_acl structure (see "Notes" below). (Input) 
code 


is a storage system status code. (Output) 


The following is the delete_acl structure: 


del 1 delete_acl (acl_count) aligned based (acl_ptr), 


2 access_name char (32), 
2 status _code fixed bin (35); 


STRUCTURE ELEMENTS 


access_name 
is the access name (in the form of Person_id.Project_id.tag) that identifies the ACL entry 
. to be deleted. 
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status_code 
is a storage system status code for this ACL entry only. 


If code is returned as error_table_$argerr, then the erroneous ACL entries in the 
delete_acl structure have status_code set to an appropriate error code. No processing is 
performed. 


If an access name cannot be matched to a name already on the ACL of the segment, 
then the status_code for that ACL entry in the delete_acl structure is set to 
error_table_$user_not_found. Processing continues to the end of the delete_acl structure 
and code is returned as 0. 


Entry: forum __Senter__trans 
This entry is used to enter a transaction into a Forum meeting. 


USAGE 


declare forum_Senter_trans entry (fixed bin, char (*), fixed bin, char (*), 
bit(]) aligned, fixed bin, fixed bin(35)); 


call forum_Senter_trans (forum_idx, text, previous _trans, subject, filled_sw, 
trans_idx, status) ; 


ARGUMENTS 


forum_idx 
identifies a meeting opened by forum_$open_forum. (Input) 


text 
is the text of the transaction to be entered. (Input) 


previous_ trans 
is the index of the transaction that this transaction is in reply to, or 0 if it is the start 
of a new chain. (Input) 


subject 
is the subject of the transaction to be entered. (Input) 


filled_sw 
is set if the transaction should not be filled on output. (Input) 


trans_idx 
is the index of the transaction entered. (Output) 


status ; 
is a standard status code. (Output) It can have the following value: 


forum_error_table_$read_only 
The caller does not have access to enter transactions in the meeting. 
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Entry: forum_$expunge 


This entry is used to physically remove deleted participant records and deleted transactions 
from a Forum meeting. This results in reclaimed storage space. 


USAGE 


declare forum_Sexpunge entry (fixed bin, bit (36) aligned, fixed bin, fixed 
bin); 


call forum_Sexpunge (forum_idx, switches, users_deleted, trans_deleted) ; 
ARGUMENTS 


forum_idx 
identifies a meeting opened by forum_$open_forum. (Input) 


switches 
is a word of switches as follows: (Input) 
transactions if set, deleted transactions should be expunged. 
users if set, deleted participant records should be expunged. 


users_deleted 
is the number of participant records which were expunged. (Output) 


trans_deleted 
is the number of transactions which were expunged. (Output) 


status 
is a standard status code. (Output) 
Entry: forum__$forum__info 
This entry is used to obtain information about a Forum meeting. 
USAGE 


declare forum_Sforum_info entry (char (*), char (*), char (*), fixed bin(71), 
ptr, fixed bin(35)); 


call forum_$forum_info (dirname, entryname, access_name, access_time, 
forum_info_ptr, status) ; 


ARGUMENTS 


dirname 
is the pathname of the directory containing the meeting. (Input) 


entryname 
is the name of the meeting. The ".forum" suffix is required. (Input) 
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access_name 
is the Person_id.Project_id.tag for which access is to be calculated. If blank, the 
access name of the caller is used. The per-user information returned is for the 
Person_id portion of access_name. (Input) 


access_time 
changed information is calculated from the specified date-time. Usually, "clock ()" should 
be passed. (Input) 


forum_info_ptr 
is a pointer to a copy of the forum_info structure described below. (Input) 


status 
is a standard status code. (Output) It can have the following value: 


forum_error_table_$not_eligible 
The user does not have access to obtain information about transaction counts and 
changes, but the chairman name is still valid in this case. 


NOTES 


The forum_info structure is declared in the include file forum_info.incl.pll and has the 
following structure: 


del 1 forum_info aligned based (forum_info_ptr), 
2 version fixed bin, 
2 forum_uid bit (36), 
2 chairman unaligned, 
3 username char (20) , 
3 project char (9), 
3 pad char (3), 
2 attendee_count fixed bin, 
2 removal_count fixed bin, 
2 transaction_count fixed bin, 
2 deletion_count fixed bin, 
2 last_seen_trans_idx fixed bin, 
2 last_time_changed fixed bin(71), 
2 last_time_attended fixed bin(71), 
2 changes_count fixed bin, 
2 flags unaligned, 
3 eligible bit(1), 
3 mbz1 bit(1), 
3 removed bit(l), 
3 notify bit(1), 
3 attending bit(1), 
3 mbz2 bit (2), 
3 read_only bit(1), 
3 adjourned bit(1), 
3 mbz3 bit (27); 
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STRUCTURE ELEMENTS 

version 
is the version number of this structure. This must be set to the constant forum_info_version_1, 
which is declared in the include file. 


forum_uid 
is the unique identifier of the meeting. 


username 
is the Person_id of the chairman of the meeting. 


project 
is the Project_id of the chairman of the meeting. 


pad 
is unused. 


attendee_count 
is the total number of participants in the meeting. 


removal_count 
is the number of participant records marked as deleted. 


transaction_count 
is the total number of transactions entered before access_time. 


deletion_count 
is the number of those transactions that have been deleted. 


last_seen_trans_idx 
is the number of the most recently entered transaction that has been read by this user. 


last_time_changed 
is the time the most recent transaction was entered. 


last_time_attended 
is the time that the user last attended the meeting. 


changes_count ' 
is the number of transactions entered since access time that the user has not seen. 


eligible 
is set if the user is eligible to attend the meeting. 


mbzl 
is unused. 


removed 
is set if the user has turned off the participating switch. 
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notify 
is set if the user has turned on the notify. 


attending 
is set if the user is currently attending the meeting. 


mbz2 
iS unused. 


read_only 
is set if the user may not enter transactions in the meeting. 


adjourned 
is set if the chairman has adjourned the meeting. 


mbz3 
is unused. 


Entry: forum__$forum_info_ idx 


This entry is used to obtain information about a Forum meeting. It is the same as the 
forum_info.entry point except that a forum_idx is used to identify the meeting instead of a 
pathname. 


USAGE 


declare forum _$forum_info_idx entry (fixed bin, char (*), fixed bin(71), ptr, 
fixed bin(35)); 


call forum_Sforum_info_idx (forum_idx, access name, access time, 
forum_info_ptr, status) ; 


ARGUMENTS 


forum_idx 
identifies a meeting opened by forum_$open_forum. (Input) 


access_name 
is the Person_id.Project_id.tag for which access is to be calculated. If blank, the 
access_ name of the caller is used. The per-user information returned is for the 
Person_id portion of access_name. (Input) 


access_time 
changed information is calculated from the specified date-time. Usually, "clock ()" should 
be passed. (Input) 


forum_info_ptr 


is a pointer to a copy of the forum_info structure described under the forum_$forum_info 
entry point. (Input) 
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Status 
is a standard status code. (Output) It can have the following value: 


forum_error_table_$not_eligibie 
The user does not have access to obtain information about transaction counts and 
changes, but the chairman name is still valid in this case. 


Entry: forum_$forum_ limits 


This entry is used to obtain various pieces of information about an open Forum meeting. 
This entry point is obsolete. The forum_$real_forum_limits entry point should be used 
instead. 


USAGE 


declare forum _Sforum_limits entry (fixed bin, fixed bin, fixed bin, fixed bin, 
fixed bin, bit(36) aligned, fixed bin(35)); 


call forum_$forum_limits (forum_idx, last_seen, first_trans, last_trans, 
new_trans_count, flags, status) ; 


ARGUMENTS 


forum_idx 
identifies a meeting opened by forum_$open_forum. (Input) 


last_seen 
is the index of the most-recently entered transaction that the user has seen, as set by 
forum_$set_last_seen_idx. (Output) 


first_trans 
is the index of the oldest transaction in the meeting. (Output) 


last_trans 
is the index of the most recent transaction in the meeting. (Output) 


new_trans_count 
is the number of transactions entered since last_seen by users other than the caller. 
(Output) 


flags 
is a collection of switches as described below. (Output) 


Status 
is a standard status code. (Output) 


B-17 CY74-02 


forum_ forum. 


The flags argument is declared in forum_flags.incl.pll and has the following strucure: 


del 1 forum_flags aligned based (addr (forum_flags_word)), 
2 chairman bit(1) unaligned, 
2 read_only bit(1) unaligned, 
2 print_cm_message bit(1) unaligned, 
2 print_acl_message bit(1) unaligned, 
2 acl_has_changed bit(1) unaligned, 
2 adjourned bit (1) unaligned, 
2 mbz2 bit (30) unaligned; 


STRUCTURE ELEMENTS 


chairman 
is set if the user is the chairman of the meeting. 


read_only 
is set if the user may not enter transactions in the meeting. 


print_cm_message 
is set if the chairman message has changed since the last time the user saw it. 


print_acl_message 
is set if the access eligibility message should be printed. 


acl_has_changed 
is sei if the access to the meeting has changed since the last time the user was informed 
that it had changed. 


adjourned 
is set if the chairman has adjourned the meeting. 


mbz 
is not used. 
Entry: forum__$get_forum_ path 


This entry is used to determine the actual name of the meeting instead of the name of the 
link used to access it. 


USAGE 


declare forum_Sget_forum_path entry (char (*), char (*), char (*), char (*), 
fixed bin (35)); 


call forum_Sget_forum_path (dirname, entryname, forum_dirname, 
forum_entryname, status) ; 
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ARGUMENTS 


dirname 
is the pathname of the directory containing the meeting. (Input) 


entryname 
is the name of the meeting. The “.forum" suffix is required. (input) 


forum_dirname 
is the pathname of the directory where the meeting actually resides. (Output) 


forum_entryname 
is the primary name of the meeting. (Output) 


status 
is a Standard status code. (Output) 


Entry: forum__$get_forum_path__idx 

This entry is used to determine the actual name of the meeting instead of the name of the 
link used to access it. It is the same as the get_forum_path entry int except that a 
forum_idx is used to identify the meeting instead of a pathname. 

USAGE 


declare forum Sget_forum_path_idx entry (fixed bin, char (*), char (*), 
fixed bin(35)); 


call forum_Sget_forum_path_idx (forum_idx, forum_dirname, forum_entryname, 
status) ; 


ARGUMENTS 


forum_idx 
identifies a meeting opened by forum_$open_forum. (Input) 


forum_dirname 
is the pathname of the directory where the meeting actually resides. (Output) 


forum_entryname 


coated ens 


is the primary name of the meeting. (Output) 


status 
is a standard status code. (Output) 
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This entry is used to read out the greeting message set by the chairman using the 


forum_§set_message entry. 

USAGE 

declare forum_S$get_message entry (fixed bin, char (*), fixed bin(35)); 
call forum_Sget_message (forum_idx, message, status) ; 

ARGUMENTS 


forum_idx 
identifies a meeting opened by forum_$open_forum. (Input) 


message 
is the text of the message, this can contain at most 256 characters. (Output) 


status 
is a standard status code. (Output) It can have the following value: 


forum_error_table_$no_message 
There is no chairman greeting message for this meeting. 


Entry: forum__$get__switch 


This entry is used to return the vaiue of Several switches associated with a Forum meeting or 


its participants. 


USAGE 


declare forum_Sget_switch entry (char (*), char (*), char (*), char (*), bit 


(1) aligned, fixed bin (35)); 


call forum _Sget_switch (dirname, entryname, person_id, switch_name, 
switch_setting, status) ; 


ARGUMENTS 


dirname 
is the name of the directory containing the meeting. (Input) 


entryname 
is the name of the meeting. The ".forum" suffix is required. (Input) 


person_id 


the user name of the user whose per-user switch value is desired. (Input) The project_id 
should not be given. Starnames are not permitted. If this is blank, the current user is 


assumed. 
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switch _name 


is the name of the switch to retrieve. (Input) See “List of Switches" below. 


switch_setting 
is the returned switch setting. (Output) 


status 
is a standard status code. It may have the following value: 


forum_error_table_Sinvalid_switch_name 
the switch_name is not one of the valid switches. 
LIST OF SWITCHES 
adjourned, adj 
prevents users from entering the meeting. 


meeting _eligibility_messages, mtg_emsg 
turns on printing of eligibility messages for this meeting. 


notify, nt 


forum_. 


turns on the notify switch for the meeting. This means that an interactive message will 
be sent each time a transaction is entered if the user is logged in and has issued the 


forum_accept_notifications command. 


participating, part 
turns on the participation switch for the meeting. 


safety 


changes the storage system safety switch for the meeting. The meeting cannot be deleted 


if this switch is on. 


Entry: forum__$get_transaction_map 


This entry is used to retrieve a bit map representing the transactions that a given participant 
has seen. This entrypoint cannot be used with meetings created with pre-MR11 software. 


USAGE 


declare forum _$get_transaction_map entry (char (*), char (*), char (*), bit 


(*), fixed bin (35)); 


call forum _$get_transaction_map (dirname, entryname, person_id, seen_map, 


status); 
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dirname 
is the name of the directory containing the meeting. (Input) 


entryname 
is the name of the meeting. (Input) The ".forum" suffix is required. 


person_id 
The username of the user whose transaction seen map is desired. (Input) Starnames are 
not permitted. If this is blank, the current user is assumed. 

seen_map 
is a bit map indicating which transactions the user has seen. If the n’th bit in this map 
is a "1"b, then the user has seen transaction "n". This variable must be large enough to 
hold one bit for each transaction in the meeting. 


status 
is a standard status code. 
Entry: forum__$get__uid_ file 
This entry returns the file system unique identifier of a meeting. 
USAGE 


declare forum _$get_uid_ file entry (char (*), char (*), bit (36) aligned, fixed 
bin (35)); 


call forum _Sget_uid_file (dir_name, entryname, uid, code) ; 
ARGUMENTS 


dirname 
is the pathname of the directory containing the meeting. (Input) 


entryname 
is the name of the meeting. (Input) The meeting suffix is required. 


uid 
is the unique identifier of the meeting. (Output) 


code 
is a standard status code. 
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Entry: forum_ Slist_ forum__aci 


This entry is used either to list the entire access control list (ACL) meeting or to return the 
access modes of specified ACL entries. This entry cannot be used with meetings created with 
pre-MR11 software. 


USAGE 


declare forum_$list_forum_acl entry (char (*), char (*), ptr, ptr, ptr, fixed 
bin, fixed bin (35)); 


call forum_$list_forum_acl (dir_name, entryname, area_ptr, area_ret_ptr, 
acl_ptr, acl_count, code); 


ARGUMENTS 


dirname 
is the pathname of the directory containing the meeting. (Input) 


entryname 
is the name of the meeting. (Input) The “.forum" suffix is required. 


area_ptr 
points to an area in which the list of ACL entries, which make up the entire ACL of 
the segment, is allocated. (input) If area_ptr is null, then the user wants access modes 
for certain ACL entries; these will be specified by the structure pointed to by acl_ptr. 


area_ret_ptr 
points to the start of the allocated list of ACL entries. (Output) 


acl_ptr 
if area_ptr is null, then acl_ptr points to an ACL Structure, segment_acl, into which 
mode information is placed for the access names specified in that same structure. (Input) 
The segment_acl structure is described in the forum_$set_forum_acl entry point. 


acl_count 
is the number of entries in the ACL structure. (Input or Output) Input is the number 
of entries in the ACL structure identified by acl_ptr. 
Output is the number of entries in the segment_acl structure allocated in the area 
pointed to by area_ptr, if area_ptr is not null. 


code 
is a storage system status code. (Output) 


NOTES 


If acl_ptr is used to obtain modes for specified access names (rather than for all access 
names on a segment), then each ACL entry in the segment_acl structure either has status_code 
set to 0 and contains the segment’s mode or has status_code set to error_table_$user_not_found 
and contains a mode of 0. 
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Eniry: forum__Siist_vi_forum__aci 
This entry is used to list the ACL of a Forum meeting. 
USAGE 


declare forum_Slist_vl_forum_acl entry (char (*), char (x), ptr, ptr, fixed bin, 
fixed bin(35)); 


call forum_$list_v1l_forum_acl (dirname, pathname, area_ptr, acl_ptr, 
acl_count, status) ; 


ARGUMENTS 


dirname 
is the pathname of the directory containing the meeting. (Input) 


entryname 
is the name of the meeting. The ".forum" suffix is required. (Input) 


area_ptr 
points to an area where the segment_acl structure is to be allocated. (Input) It can not 
be null. 

acl_ptr 
points to the allocated segment_acl structure. This structure is described in the 
hes_$add_acl_entries subroutine. (Output) 


acl_count 


is the number of ACL entries in the segment_acl structure. (Output) 
Status 
is a standard status code. (Output) 
Entry: forum__Slist__users 
This entry is used to extract information about the participants in a Forum meeting. 
USAGE 
declare forum_Slist_users entry (char (*), char (*) » ptr, ptr, fixed bin(35)); 
call forum_$list_users (dirname, entryname, area_ptr, user_list_ptr, status) ; 
ARGUMENTS 


dirname 
is the pathname of the directory containing the meeting. (Input) 
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entryname 


is the name of the meeting. The ".forum" suffix is required. (Input) 


area_ptr 


is a pointer to an area where the user_list structure is to be allocated. 


not be null. 


user_list_ptr 


is a pointer to the user_list structure described below. (Output) 


Status 


is a standard status code. (Output) 


NOTES 


forum_ 


(Input) It can 


The user_list structure is declared in the include file forum_user_list.incl.pll and has the 


following structure: 


del 1 user_list 
2 version 
2 chairman 
3 person_id 
3 project_id 
2 transaction_count 
2 no_attendees 
2 attendee 


3 person_id 

3 project_id 

3 attending 

3 mbz!l 

3 notify 

3 removed 

3 read_oniy 

3 mbz2 

3 last_time_attended 
3 highest_trans_seen 


STRUCTURE ELEMENTS 


version 


based (user_list_ptr) aligned, 
fixed bin, 
aligned, 
char (22) unaligned, 
char (9) unaligned, 
fixed bin, 
fixed bin, 
(user_list_no_attendees 
refer (user_list.no_attendees)), 
char (22) unaligned, 
char (11) unaligned, 
bit(1) unaligned, 
bit(2) unaligned, 
bit(]) unaligned, 
bit(1) unaligned, 
bit(1) unaligned, 
bit(3) unaligned, 
fixed bin(71), 
fixed bin; 


is the version number of this structure. Currently, this is set to the constant 
user_list_version_1 which is also declared in the include file. 


person_id 


is the Person_id of the chairman of the meeting. 


project_id 


is the Project_id of the chairman of the meeting. 
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transaction_count 
is the total number of transactions in the meeting. 


no_attendees 
is the total number of non-deleted participants in the meeting. 


person_id 
is the Person_id of this participant. 


project_id 
is the Project_id of this participant. 


attending 
is set if this participant is currently attending the meeting. 


mbzl 
is not used. 


notify 
is set if this participant has requested notifications. 


removed 
is set if this participant has turned off the participating switch. 


read_only 
is set if this user may not enter transactions in the meeting. 


mbz2 
is not used. 


last_time_attended 
is the time the participant last attended the meeting. 


highest_trans_seen 

is the index of the most-recently entered transaction that the user has read. 
Entry: forum __S$list__users__idx 
This entry is used to extract information about the participants in a Forum meeting. It is the 
same as the list_users entry point except that a forum_idx is used to identify the meeting 
instead of a pathname. 
USAGE 


declare forum Slist_users_idx entry (fixed bin, ptr, ptr, fixed bin(35)); 


call forum_Slist_users_idx (forum_idx, area_ptr, user_list_ptr, status) ; 
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ARGUMENTS 


forum_idx 
identifies a meeting opened by forum_$open_forum. (Input) 


area_ptr 


is a pointer to an area where the user_list structure is to be allocated. (Input) It can 
not be null. 


user_list_ptr 
is a pointer to the user_list structure described under the forum_$list_users entry point. 
(Output). 

Status 
is a standard status code. (Output) 


Entry: forum__$open_ forum 


This entry opens a meeting and returns the forum_idx used in many of the other calls to 
forum_. 


USAGE 

deciare forum_Sopen_forum entry (char (*), char (*), fixed bin, fixed bin(35)); 
call forum_Sopen_forum (dirname, entryname, forum_idx, status) ; 

ARGUMENTS 


dirname 
is the pathname of the directory containing the meeting. (Input) 


entryname 
is the name of the meeting. The ".forum" suffix is required. (Input) 


forum_idx 
is the index number used in subsequent calls to forum_ that take a forum index. All 
coexistent openings of the same meeting in the same process will return the same 
number. (Output) 


Status 
is a standard status code. If this is non-zero the meeting could not be opened. (Output) 
It can have one of the following values: 


forum_error_table_$meeting_adjourned 
The chairman has adjourned the meeting. Only the chairman can attend. 


forum_error_table_$no_such_forum 
The dirname-entryname pair does not exist. 
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forum_error_table_$not_a_forum 
The segment named by dirname and entryname is not a Forum meeting. 


forum_error_table_$not_eligible 
The caller has insufficient access to participate in the meeting. 


Entry: forum__$read_ trans 


This entry is used to read a transaction from a Forum meeting. 


USAGE 


declare forum_Sread_trans entry (fixed bin, fixed bin, ptr, ptr, 
fixed bin (35)); 


call forum_Sread_trans (forum_idx, trans_idx, area_ptr, forum_user_trans_ptr, 
status) ; 


ARGUMENTS 


forum_idx 
identifies a meeting opened by forum_$open_forum. (Input) 


trans_idx 
is the index of the transaction to be read. (Input) 


area_ptr 
is a pointer to an area where the forum_user_trans structure is to be allocated. (Input) 


forum_user_trans_ptr 
is a pointer to the forum_user_trans structure described below. (Output) 


status 
is a standard status code. (Output) It can have the following values: 


forum_error_table_$invalid_trans_idx 
There is no transaction corresponding to the supplied index. 


forum_error_table_$trans_deleted 


The deleted switch is set for this transaction and the caller is neither the chairman 
nor the author. 


forum_error_table_$trans_reaped 
The transaction has been physically removed from the meeting. 


a 


forum_ 


NOTES 


forum__ 


The forum_user_trans structure is declared in forum_user_trans.incl.pll and has the following 


structure: 


dcl 1 forum_user_trans 


based (forum_user_trans_ptr) aligned, 


2 type fixed bin, 

2 person_id char (22), 

2 project_id char (9), 

2 time fixed bin(71), 

2 trans_no fixed bin, 

2 next_trans_ptr ptr, 

2 prev_trans_ptr ptr, 

2 subject_length fixed bin, 

2 text_length fixed bin, 

2 unfilled bit(1) aligned, 

2 subject unaligned char (0 refer 
forum_user_trans.subject_length) ) 

2 text unaligned char (0 refer 


forum_user_trans.text_length)); 


STRUCTURE ELEMENTS 


person_id 

is the Person_id of the author of this transaction. 
project_id 

is the Project_id of the author of this transaction. 


time 
is the clock reading of the time the transaction was entered. 


trans_no 
is the index of this transaction. 


next_trans_ptr 
is intended to be used to thread transactions together. It is set to null. 


t t+ 
prev_trans_ptr 


pierv_ pu 
is intended to be used to thread transactions together. It is set to null. 


subject_length 
is the length, in characters, of the subject of the transaction. 


text_length 
is the length, in characters, of the text of fhe transaction. 
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unfilled 


is set if the transaction should not be filled on output 


subject 
is the subject of the transaction. 


text 
is the text of the transaction. 


Entry: forum__$refuse__notifications 

This entry turns off reception of forum notifications by the calling process. 
USAGE 

declare forum_Srefuse_ notifications entry (fixed bin(35)) ; 
call forum_Srefuse_notifications (status) ; 

ARGUMENT S 


Status 
is a standard status code. (Output) It can have the following value: 


forum_error_table_$no_notify_seg 
The notifications database could not be initiated. 
Entry: forum_ $replace_forum_ acl 
This entry replaces an entire access control list (ACL) for a meeting with a user-provided 
ACL, and can optionally add an entry for *.SysDaemon.* with mode rw to the new ACL. 
This entry cannot be used on meetings created with pre-MR11 software. 
USAGE 


declare forum_Sreplace_forum_acl entry (char (*), char (*), ptr, fixed bin, 
bit(1), fixed bin(35)); 


call forum_S$replace_forum_acl (dirname, entryname, acl_ptr, acl_count, 
no_sysdaemon_sw, code) ; 


ARGUMENTS 


dirname 
is the pathname of the directory containing the meeting. (Input) 
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entryname 
is the entryname of the meeting. (Input) The ".forum" suffix is required. 


acl_ptr 
points to the user supplied segment_ac] structure that is to replace the current ACL. 
(Input) The segment_acl structure is described in the forum_$set_forum_acl entry point. 


acl_count 
is the number of entries in the segment_acl structure. (Input) 


no_sysdaemon_sw 
is a switch that indicates whether an rw *.SysDaemon.* entry is to be put on the ACL 
of the meeting after the existing ACL has been deleted and before the user-supplied 
segment_ac] entries are added. 


(Input) 
"O"b adds rw *.SysDaemon.* entry 


"I"b replaces the existing ACL with only the user-supplied 
segment_ac] 


code 
is a storage system status code. (Output) 


NOTES 

If acl_count is zero, then the existing ACL is deleted and only the action indicated (if any) 
by the no_sysdaemon_sw switch is performed. If acl_count is greater than zero, processing of 
the segment_ac]l entries is performed top to bottom, allowing later entries to overwrite 
previous ones if the access_name in the segment_acl structure is identical. 

Entry: forum__$set_delete_sw 

This entry is used to delete or retrieve a transaction. 


USAGE 


declare forum_Sset_delete_sw entry (fixed bin, fixed bin, bit(1) aligned, 
fixed bin(35)); 


call forum_$set_delete_sw (forum_idx, trans_idx, delete_sw, status); 
ARGUMENTS 


forum_idx 
identifies a meeting opened by forum_$open_forum. (Input) 


trans_idx 
is the index of the transaction whose delete switch is to be changed. (Input) 
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delete_sw 
should be on to delete the transaction, or off to retrieve it. 


Status 
is a standard status code. (Output) It can have one of the following values: 


forum_error_table_$chairman_only 
The caller is neither the author of the transaction nor the chairman of the meeting. 


forum_error_table_$invalid_trans_idx 
There is no transaction corresponding to the supplied index. 


Entry: forum__$set_event__channel 


This entry is used to set the event channel used to send wakeups when interesting forum 
events occur. 


USAGE 


declare forum_Sset_event_channel entry (char (*), char (*), fixed bin(71), 
fixed bin(35)); 


call forum_$set_event_channel entry (dirname, entryname, event_channel, 
status) ; 


ARGUMENTS 


dirname 
is the pathname of the directory containing the meeting. (Input) 


entryname 
is the name of the meeting. The "forum" suffix is required. (Input) 


event_channel 
is the event channel which should receive wakeups from other users attending the same 
meeting. (Input) 


Status 
is a standard status code. (Output) 


NOTES 


Currently, the only wakeup sent by Forum occurs when a transaction is entered while you are 
attending the meeting. The message passed with this wakeup is: 


dcl 1 forum_message, 


2 uid bit(36) aligned, 
2 attendee_idx fixed bin; 
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STRUCTURE ELEMENTS 
uid 
is the unique identifier of the meeting. It should be passed to forum_$validate_uid to 
ensure that the user is still attending that meeting. 
attendee_idx 
identifies the user who entered the transaction. A character string containing the name of 
that user can be obtained by passing this to forum_$convert_attendee_idx. 


Entry: forum_$set_event_channel__idx 


This entry is used to set the event channel used to send wakeups when interesting forum 
events occur. 


USAGE 


declare forum_Sset_event_channel_idx entry (fixed bin, fixed bin(71), 
fixed bin(35)); 


call forum Sset_event_channel_idx entry (forum_idx, event_channel, status) ; 


forum_idx 
identifies a meeting opened by forum_$open_forum. (Input) 

event_channel 
is the event channel which should receive wakeups from other users attending the same 
meeting. (Input) 


status 
is a standard status code. (Output) 


NOTES 


See the forum_$set_event_channel entry point for a description of interprocess messages used 
by Forum. 
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Entry: forum__$set__forum__acl 

This entry adds specified access modes to the access control list (ACL) of a meeting. If an 
access name already appears on the ACL of the segment, its mode is changed to the one 
specified by the call. This entry cannot be used on meetings created with pre-MR11 
software. 

USAGE 


declare forum_Sset_forum_acl entry (char (*), char (*), ptr, fixed bin, fixed 


bin (35)); 
call forum_S$set_forum_acl (dirname, entryname, acl_ptr, acl_count, code) ; 
ARGUMENTS 


dirname 
is the name of the directory containing the meeting. (Input) 


entryname 
is the name of the meeting. (Input) The meeting suffix is required. 


acl_ptr 
points to a user-filled segment_acl_array structure (see "Notes" below). (Input) 


ac]_count 
contains the number of ACL entries in the segment_acl_array structure (see "Notes" 
below). (Input) 


code 
is a storage system status code. (Output) 


NOTES 
The segment_acl_array structure should be declared in the following way: 
dcl segment_acl_array (acl_count) aligned like segment_acl_entry; 


The segment_acl_entry structure (declared in the include file acl_structures.incl.pll) is as 
follows: 


dcl 1 segment_acl_entry aligned based, 
2 access_name char (32) unaligned, 
2 mode bit (36) aligned, 
2 extended_mode bit (36) aligned, 
2 status code fixed bin (35) ; 
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STRUCTURE ELEMENTS 


access_name 


forum_ 


is the access name (in the form Person_id.Project_id.tag) that identifies the processes to 


which this ACL entry applies. 
mode 


contains the modes for this access name. This must be set to the constant RW_ACCESS 


declared in the include file access_mode_values.incl.pl1. 


extended_ mode 


is the extended access mode for this access mode. It must be set to one of the constants 


declared in forum_access_modes.incl.pl1. 


status_code 


is a storage system status code for this ACL entry only. If code is returned as 
error_table_$argerr, then the erroneous ACL entries in the segment_acl structure have 


status_code set to an appropriate error code. No processing is performed. 


Entry: forum__$set__message 

This entry is used to set a chairman’s greeting message for a Forum meeting. 
USAGE 

declare forum_Sset_message entry (fixed bin, char (*), fixed bin(35)); 
call forum_Sset_message (ferum_idx, message, status) ; 

ARGUMENTS 


forum_idx 
identifies a meeting opened by forum_$open_forum. (Input) 


message 
is the text message, this can contain at most 256 characters. (Input) 


Status 
is a standard status code. (Output) It can have one of the following values: 


forum_error_table_$chairman_only 
The caller is not the chairman of the meeting. 


forum_error_table_$message_too_long 
The message exceeds the 256 character limit. 
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Entry: forum__$set_seen__switch 


This entry marks a transaction as having been seen by a participant. This entry cannot be 
used on meetings created with pre-MR11 software. 


USAGE 


declare forum_Sset_seen_switch entry (fixed bin, char (*), fixed bin, bit (1) 
aligned, fixed bin (35)); 


call forum_Sset_seen_switch (forum_idx, person_id, trans_idx, value, status) ; 
ARGUMENTS 


forum_idx 
identifies a meeting opened by forum_$open_forum. (Input) 


person_id 
is the user name of the participant for whom the transaction is to be marked as seen. 
(Input) If this is blank, the person_id of the caller is assumed. Chairman access is 
Tequired to change a seen switch for another participant. 


trans_idx 
is the number of the transaction to be marked. (Input) 


value 
is on if the transaction is to be marked as seen, and off otherwise. (Input) 


status 
is a standard status code. (Output) 
Entry: forum__$set__switch 


This entry is used to change several switches associated with a Forum meeting or its 
participants. 


USAGE 


declare forum_Sset_switch entry (char (*), char (*), char (*), char (*), bit (1) 
aligned, fixed bin (35)); 


call forum_Sset_switch (dirname, entryname, person_id, switch_name, 
switch_setting, status) ; 


ARGUMENTS 


dirname 
is the pathname of the directory containing the meeting. (Input) 
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entryname 
is the name of the meeting. The ".forum" suffix is required. (Input) 


person_id 
is the Person_id of the user on whose behalf you are setting the switch. The Project_id 
should not be given. Starnames are not permitted. If this is blank, the current user is 
assumed. Oniy the chairman of a forum can set switches for persons other than herself. 
(Input) 


switch_name 
is the name of the switch to set. See “List of Switches" below. (Input) 


switch_setting 
is the new switch setting. (Input) 


status 
is a standard status code. It can have one of the following values: 


forum_error_table_$chairman_only 
Person_id does not identify the caller and the caller is not the chairman. 


forum_error_table $invalid switch name 
The switch_name is not one of the valid switches. 


forum_error_table_$switch_not_changed 
The old setting was the same as the new setting. 


LIST OF SWITCHES 


adjourned, adj 
Prevents users from entering the meeting. Only the chairman can set this switch. 


meeting eligibility_messages, mtg_emsg 
Turns on printing of eligibilty messages for this meeting. This switch can only be set by 
the chairman. 


notify, nt . 
Turns on the notify switch for the meeting. This means that an interactive message will 
be sent each time a transaction is entered if the user is logged in and has issued the 
forum_accept_notifications command. 


participating, part 
Turns on the participation switch for the meeting. 


safety 


Changes the storage system safety switch for the meeting. The meeting cannot be deleted 
if this switch is on. 
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Entry: forum__S$set_switch__idx 


This entry is used to change several switches associated with a Forum meeting or its 
participants. It is the same as the set_switch entry point except that a forum_idx is used to 
identify the meeting instead of a pathname. 


USAGE 


declare forum_Sset_switch_idx entry (fixed bin, char (*), char (*), 
bit(1) aligned, fixed bin(35))3; 


call forum _Sset_switch_idx (forum_idx, person_id, switch_name, switch_setting, 
status) ; 


ARGUMENTS 


forum_idx 
identifies a meeting opened by forum_$open_forum. (Input) 


person_id 
is the Person_id of the user on whose behalf you are setting the switch. The Project_id 
should not be given. Starnames are not permitted. If this is blank, the current user is 
assumed. Only the chairman of a forum can set switches for persons other than herself. 
(Input) » 


switch_name. 

is the name of the switch to set. See "List of Switches" below. (Input) 
switch_setting 

is the new switch setting. (Input) 


status 
is a standard status code. It can have one of the following values: 


forum_error_table_$chairman_only 
Person_id does not identify the caller and the caller is not the chairman. 


forum_error_table_$invalid_switch_name 
The switch_name is not one of the valid switches. 


forum_error_table_$switch_not_changed 
The old setting was the same as the new setting. 


LIST OF SWITCHES 


access_changed ; 
Specifies that the ACL on the meeting has changed. This switch is set by the 
forum_chairman_$set_forum_acl entry point, and should normally only be turned off by 
this subroutine. 
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adjourned, adj 
Prevents users from entering the meeting. Only the chairman can set this switch. 


deleted 
Specifies that the attendee record for this user should be marked as deleted. 


meeting eligibility messages, mtg_emsg 
Turns on printing of eligibilty messages for this meeting. This switch can only be set by 
the chairman. 


message_seen 
Specifies that the chairman message on the meeting has changed. This switch is set by 
the forum_$set_message entry point, and should normally only be turned off by this 
subroutine. 


notify, nt 
Turns on the notify switch for the meeting. This means that an interactive message will 
be sent each time a transaction is entered if the user is logged in and has issued the 
forum_accept_notifications command. 


participating, part 
Turns on the participation switch for the meeting. 


safety 
Changes the storage system safety switch for the meeting. The meeting cannot be deleted 
if this switch is on. 


Entry: forum__$trans__ref_ info 


This entry is used to obtain information about an individual transaction. This entry is 
obsolete. The forum_$real_trans_ref_info entry should be used instead. 


USAGE 


declare forum Strans_ref_info entry (fixed bin, fixed bin, fixed bin, 
fixed bin, bit(1) aligned, fixed bin(35)); 


call forum_Strans_ref_info (forum_idx, trans_idx, prev_ref, next_ref, 
deleted_sw, status) ; 


ARGUMENTS 


forum_idx 
identifies a meeting opened by forum_$open_forum. (Input) 


trans_idx 
is the index of the transaction for which information is desired. (Input) 
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prev_ref 
is the index of the preceding transaction in the same transaction chain. This is zero if 
the transaction is the first in a chain. (Output) 


next_ref 


is the index of the next transaction in the same transaction chain. This is zero if the 
transaction is the last in a chain. (Output) 


deleted_sw 
is set if the transaction has been marked as deleted. (Output) 


Status 
is a standard status code. (Output) It can have one of the following values: 


forum_error_table_$invalid_trans_idx 
There is no transaction corresponding to the supplied index. 


forum_error_table_$trans_reaped 
The transaction has been physically removed from the meeting. 
Entry: forum__$trans_time_ info 
This entry returns the indexes of transactions entered during a given time span. 
USAGE 


declare forum _Strans_time_info entry (fixed bin, fixed bin(71), fixed bin(71), 
fixed bin, fixed bin, fixed bin(35)); 


call forum_Strans_time_info (forum_idx, low_time, high_time, low_trans, 
high_trans, status) ; 


ARGUMENTS 


forum_idx 
identifies a meeting opened by forum_$open_forum. (Input) 


low_time | 

is the timestamp of the low end of the time span. (Input) 
high_time 

is the timestamp of the high end of the time span. (Input) 
low_trans 


is the index of the first transaction entered after low_time. If there are no transactions 
that new, than the index of the highest transaction in the meeting is returned. (Output) 
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high_ trans 
is the index of the transaction entered immediately before high time. If no transactions 
were entered before then, zero is returned. (Output) 

status 
is a standard status code. (Output). 

Entry: forum__$validate_ uid 


This entry is used to determine if a given meeting unique identifier (uid) corresponds to a 
given meeting. 


USAGE 

declare forum_Svalidate_uid entry (fixed bin, bit (36) aligned, fixed bin(35)); 
call forum_$validate_uid (forum_idx, forum_uid, status) ; a 
ARGUMENTS 


forum_idx 
identifies a meeting opened by forur 


forum_uid 
is the uid of the meeting. Normally this is cbtained from Forum interprocess messages. 
(Input) 


status 
is a standard status code. (Output) It can have the following value: 


forum_error_table_$incorrect_uid 
The supplied uid is not the unique identifier of the meeting identified by forum_idx. 
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Name: forum__admin__ 

The forum_admin_ subroutine provides a site administrative interface to the Forum Interactive 
Meeting System. 

Entry: forum_admin_$change_ chairman 


This entry is used to change the chairman of a Forum meeting by a system administrator 
who is not the current chairman of the meeting. 


USAGE 


declare forum_admin_Schange_chairman entry (char (*), char (*), char (x), 
fixed bin(35)); 


call forum_admin_S$change_chairman (dirname, entryname, chairman, status) ; 
ARGUMENTS 


dirname 
is the pathname of the directory containing the meeting. (Input) 


entryname 
is the entryname of the meeting. (Input) The ".forum" suffix is required. 


chairman 
is the name of the new chairman of the meeting, in the form Person_id.Project_id. The 
new chairman must already be a participant. (Input) 


status 
is a standard status code. (Output) It can have one of the foliowing vaiues: 


forum_error_table_$no_such_user 
The supplied new chairman is not a participant. 


ACCESS REQUIRED 


The caller must have modify permission on the containing directory. 


Entry: forum__admin__$convert 


This entry is used to convert a meeting created with pre-MR11 software into a current 
version meeting without requiring the user to be the chairman. 


USAGE 
declare forum_admin_Sconvert entry (char (*), char (*), fixed bin (35)); 


call forum_admin_ Sconvert (dirname, entryname, status); 
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ARGUMENTS 


dirname 
is the name of the directory containing the meeting. (Input) 


entryname 
is the name of the meeting. (Input) The ".forum” suffix is required. 


Status 
is a Standard status code. 


ACCESS REQUIRED 


The caller must have modify permission on the containing directory. 


Entry: forum_admin_ $delete_forum 


This entry is used to delete a meeting by a system administrator who is not the current 
chairman of the meeting. 


USAGE 

declare forum_admin_Sdelete_forum entry (char (*), char (*), fixed bin(35)); 
call forum_admin_S$delete_forum (dirname, entryname, status) ; 

ARGUMENTS 


dirname 
is the pathname of the directory containing the meeting. (Input) 


entryname 
is the entryname of the meeting. The ".forum" suffix is required. (Input) 


Status 
is a standard status code. (Output) 


ACCESS REQU/RED 


The caller must have modify permission on the containing directory. 
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This entry is used to create the notifications database. 

USAGE 

declare forum_admin_Sinit_notifications entry (fixed bin(35)); 
call forum_admin_Sinit_notifications (status) ; 

ARGUMENTS 


status 
is a standard status code. (Output) 


ACCESS REQUIRED 


The caller must have "sma" access to the central forum directory. 


Entry: forum__admin_ $set_forum__acl 


This entry is used to add or change an ACL term on a meeting. ACL terms can only be 
specified for Person_id.* or *.Project_id, terms of the form Person_id.Project_id are not 
allowed. The caller need not be the chairman of the meeting. 


USAGE 


declare forum_admin_Sset_forum_acl] entry (char (*), char (*), char (*), bit (1) 
aligned, bit(1) aligned, bit(1) aligned, fixed bin(35)); 


call forum_admin_Sset_forum_ac! (dirname, entryname, access name, user_sw, 
set_sw, write_sw, status) ; 


ARGUMENTS 


dirname 
is the pathname of the directory containing the meeting. (Input) 


entryname 
is the entryname of the meeting. The ".forum” suffix is required. (Input) 


access_name 


is the Person_id or Project_id whose ACL is to be added or deleted. Access_name can 
not contain a ".". (Input) 


user_Sw 


This switch should be on if access_name is a Person_id, and off if it is a Project_id. 
(Input) 
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set_sw 
This switch should be on if access is to be added, and off if it is to be deleted. (Input) 


write_sw 
This switch should on if write access is to be added, and off if only read access is to 
be added. This switch is ignored if set_sw is off. (Input) 


status 
is a standard status code. (Output) 


ACCESS REQUIRED 


The caller must have modify permission on the containing directory. 


Entry: forum__admin_ $set_global_switch 
This entry is used to set switches associated with the forum environment for an entire site. 
USAGE 


declare forum_admin_$set_global_switch entry (char(*), bit(1) aligned, fixed 
bin (35)) ; 


cali forum_admin_Sset_global_switch (switch_name, value, status) ; 
ARGUMENTS 


switch_name 
is the name of the switch to be set. It can be one of "print_eligiblity_messages", 


ve " 


"pemsg", "chairman_set_eligibilty_msg", or "cm_set_emsg”. (Input) 


value 
is the value to be assigned to the switch. (Input) 


Status 
is a standard status code. (Output) It can have the following value: 


forum_error_table_$invalid_switch_name 
The switch_name given was not one of those listed above. 


ACCESS REQU/ RED 


The user must have "rw" access to forum_data_. 
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This entry is used to change several switches associated with a Forum meeting or its 
participants. The caller need not be the chairman of the meeting in order to set any of the 
switches. 


USAGE 


declare forum_admin_Sset_switch entry (char (*), char (*), char (*), char (*), 
bit(1) aligned, fixed bin(35)); 


call forum_admin_Sset_switch (dirname, entryname, person_id, switch_name, 
switch_setting, status) ; 


ARGUMENTS 


dirname 
is the pathname of the directory containing the meeting. (Input) 


entryname 
is the name of the meeting. The ".forum" suffix is required. (Input) 


person_id 
is the Person_id of the user on whose behalf you are setting the switch. The Project_id 


should not be given. Starnames are not permitted. If this is blank, the caller’s Person_id 
is used. (Input) 


switch_name 
is the name of the switch to set. See "List of Switches" below. (Input) 


switch_setting 
is the new switch setting. (Input) 


Status 
is a standard status code. It can have one of the following values: 


forum_error_table_$invalid_switch_name 
the switch_name is not one of the valid switches. 


forum_error_table_$switch_not_changed 
the old setting was the same as the new setting. 
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forum_admin_ forum_admin_ 


. LIST OF SWITCHES 


access_changed 
Specifies that the ACL on the meeting has changed. This switch is set by the 
forum_chairman_$set_forum_acl entrypoint, and should normally only be turned off by 
this subroutine. 


adjourned, adj 
Prevents users from entering the meeting. 


deleted 
Specifies that the attendee record for this user should be marked as deleted. 


meeting _eligibility_messages, mtg_emsg 
Turns on printing of eligibilty messages for this meeting. 


message_seen 
Specifies that the chairman message on the meeting has changed. This switch is set by 
the forum_$set_message entrypoint, and should normally only be turned off by this 
subroutine. 


notify, nt 
Turns on the notify switch for the meeting. This means that an interactive message will 
be sent each time a transaction is entered if the user is logged in and has issued the 
forum_accept_notifications command. 
participating, part 
Turns on the participation switch for the meeting. 


ACCESS REQUIRED 


The caller must have either modify permission on the containing directory or write access to 
the ".forum" segment. 


B-47 CY74-02 


APPENDIX C 
GLOSSARY 


Like every system, Forum has some terms that have special meaning. This section will 
attempt to make some of them clear. 


attending, attendee 
A user is attending a meeting if he or she is currently using the Forum system 
and has entered that meeting (using the forum “goto” request). Attending is 
analogous to being inside the room where the meeting is being held, as 
opposed to participating, which is like having been there and gone out for 
coffee. 


chairman 
The chairman of a meeting is the user who controls the activities in the 
meeting. Usually it is the user who created or convened the meeting in the 
first place, but since the chairmanship can be passed on to another user, this is 
not always the case. It is the chairman who can adjourn meetings and controls 
such things as who is eligible to participate in the meeting. He can also delete 
and retrieve transactions. 


control arguments 
Forum commands and requests all perform a specific function, and most have 
special options that modify the default action or tell Forum exactly which 
transactions or meetings to operate on. Controj arguments always start with the 
"“~" character. 


current meeting 
The current meeting is the one you are currently attending, and remains so 
until you explicitly attend a different meeting (using the "goto" request) or exit 
Forum (using the "quit" request). 


current transaction 
The current transaction is the one that the user has just listed, printed, 
entered, or otherwise referred to. Since Forum keeps track of the current 
transaction, it performs requests that are issued with no transaction specifier on 
the current transaction (this is the default). 


eligible 
A user is eligible to participate in a meeting if the chairman of the meeting 
has set the access on the meeting in such a way as to allow that user to 
participate in the meeting. A user must be eligible to participate before he or 
she can attend. 
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flag 
Flags are printed when you list either meetings or participants in a meeting. 
Flags consist of one letter and indicate the user’s state with respect to that 
meeting (e.g., "a" means that you are currently attending that meeting, "“e” 
means eligible to participate and “p" means you are already a participant). 


Forum 
Forum is the system itself and the programs or software that comprise it 
Forum enables eligible users to create, enter, participate in, and manage 
meetings. 


forum 
When you type "forum" at command level, you are typing the forum 
command, which enters you into the Forum subsystem (see also Forum). 


keyword 
A keyword is a transaction specifier consisting of a generic term that describes 
one or more transactions (e.g., "first" and "all"). 


meeting . 
A meeting consists of a chairman, a list of participants, and the proceedings or 
minutes. Meetings are Forum’s reason for existence. There will likely be many 
meetings on a system, each created to discuss some specific or general topic or 
issue. Each meeting is identified by a long, descriptive name (such as 
Everybody’s_Meeting), and at least one short, easy-to-use name (such as eve). 


participate, participant 
A user is considered to be participating in a meeting if he or she has entered 
that meeting at least once. The first time a user goes to a meeting, a record 
of that user’s participation in that meeting is created, making the user an 
official participant. 


proceedings 
The proceedings of a meeting are the record maintained by Forum of what 
exactly has been said during the life of the meeting, and by whom. This 
record of what took place can be examined in a flexible fashion by 
participants of the meeting. 


regular expression 
Regular expressions are transaction specifiers used with Forum requests. They 
consist of character strings (letters, numbers, words, or phrases) enclosed in 
slashes (/) to be matched against the text of transactions. Certain special 
characters can be used for fancier matching techniques. See Section 4. 
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request 
A request is how a participant tells Forum to perform some action, such as 
entering a meeting, printing out transactions, or finding out the names of the 
other participants in a meeting. Forum requests are very similar in syntax to 
Multics commands. 


request line 
A request line is a Forum request, optionally followed by arguments, control 
arguments, and transaction specifiers. 


request loop 
The request loop is the part of Forum that reads the request you type, 
performs the specified operation, and finishes with a prompt to you (forum:) 
for another request. This is a repeating cycle until you exit Forum. 


search list 
The forum search list is a list of pathnames of directories that contain 
meetings which you want to attend. It is manipulated via the add_search_paths 
and delete_search_paths commands, and printed with the print_search_paths 
command (all described in the Commands manual). 


search path 
A search path is a pathname of a directory in your search list. 


transaction 
A transaction is a statement made by an attendee in a meeting. Entering a 
transaction is Forum’s equivalent of speaking at a real meeting. The text of 
the transaction, its subject, the date and time it was entered, and the name of 
the participant who entered it are placed in the proceedings of a meeting. 
Other participants can then use Forum requests to manipulate the transactions 
of the meeting, such as "print" and "list" to look at the transaction. 


transaction chain 
A transaction chain is a series of transactions that are related in that they all 
refer to one previous transaction. In other words, it is a discussion centered 
on the transaction of one user, linked together by a common subject (see 
"Transaction Chains” above). 


transaction specifier 
A transaction specifier is a way of choosing a transaction or a group of 
transactions for Forum to list, print, write, or otherwise refer to. Transaction 
specifiers come in many forms: transaction numbers, keywords, control 
arguments, and regular expressions. 


unprocessed transaction 
An unprocessed transaction is a transaction whose text you have prepared either 
in response to another transaction, or to start a new discussion in a meeting, 
but have not yet entered it into the proceedings of the meeting. It can be 
manipulated in a number of ways (see Section 4). 
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INDEX 


MISCELLANEOUS advanced requests 6-1 


allref (aref) keyword 3-4 
(current) request 4-7, 5-3, 


773 announcement_info (ai) request 
1~9 | 
- COMMAND_LINE escape 5-2, 
6-2, 7-3 announce_meeting (am) request 
7-8 | 


? request 2-2, 5-1 
see also help answer request 7-10 


apply (ap) request 4-6, 7-12 


A 
attendee C-1 
record 9-5 
abbrev (ab) request 6-6, 7-4 
abbreviations 6-5 C 
abbrev request 6-6 
active requests 3-6, 6-1 central forum directory 2-2 
add_meeting (am) request 7-5 chain-tracing keywords 3-4 
as active requests 3-6 
add_participant (apt) request as requests 3-6 
I fat | 
chairman C-1 
add project (apj) request 7-7 changing A-1 
administrative information chairman (cm) request 2-5, 
A-1 7-14 


forum_admin command A-4 
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chairman’s commands 


convert_forum 10-9 
forum_add_ participant (fapt) 
10-2 
forum_add_project (fapj) 
10-3 
forum_create (fcr) 10-4 
forum_delete (fdl) 8-12 


forum_make_public (fmp) 
command 10-5 

forum_remove_participant 
(frpt) command 10-6 

forum_remove_project (frpj) 
10-7 

forum_unmake_public (fump) 
10-8 


chairman’s duties 
creating a meeting 9-1 
deleting a meeting 9-11 
maintaining a meeting 9-2 


adding a participant 9-3 

adding a project 9-& 

deleting transactions 9-7 

making a meeting private 
9-4 

making a meeting public 
9-4 

printing eligibility 
messages 9-9 

removing a participant 
9=5 


removing a project 9-6 
retrieving participants 


and transactions 9-8 
setting a message 9-9 
chairman’s message 4-1 
setting 9-9 
chairman_message (cmsg) 
keyword 3-6 
character string matching 
regular expressions 3-8 


check_meetings (ckm) request 


7-15 


command processor escape 5-2, 


6-2, 7-3 


commands 
administrative A-4 
chairman commands 
user commands 8-1 


10-1 


conditional execution 
if request 6-3 
control arguments C-1 
and requests 6-1 
as transaction specifiers 
3-6 


convert_forum 10-9 


creating a meeting 9-1 


specifying participants 9-2 
current (.) request 4-7, 5-3, 
ie 
current meeting C-1 
current transaction 3-3, C-1 


current_meeting (cmtg) request 


7-16 


date and time control 
arguments 3-7 


delete (dl) request 4-9, 7-16, 


9-7 


delete_participant (dlpt) 
request 7-18, 9-5 


deleting a meeting 9-11 


do request 


7-18 
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editors 
emacs 4-6 
qedx 4-3 
ted 4-3 


eligibility message 2-5, A-3 


eligible C-1 


enter (en, send) request 7-20 
execute (e) request 6-3, 7-22 
exec_com (ec) request 6-6, 
i721 
exec_coms 6-6 
start_up.ec 6-8 
start_up.fmec 6-7 
exiting forum 2-7 
expunge request 7-22, 9-5, 


9-8 


fant 


see forum_accept_notifications 


fapj 
see forum_add project 


fapt 
see forum_add_participant 


fer 
see forum_create 


fd 
see forum_dir 


fdl 
see forum_delete 
fiii (fi) request 4-8, 7-23 


firstref (fref) keyword 3-4 


flags 2-2, 7-34, 8-17, 8-20, 
C-2 
notify 3-12 


fism 
see forum_list_meetings 


flsu 
see forum_list_users 


fmp 
see forum_make_public 


formatting saved transactions 


3-3 


Forum 1-1, C-2 
abbreviations 6-5 
advanced requests 6-1 
benefits and typical uses 

b=1 

-central directory 2-2. 
control arguments 6-4 
entering 2-1 
exec_coms 6-6 
exiting 2-7 
getting help 2-2 
on-line help 5-1 
prompt 6-5 
request loop 2-1 
search list 2-3 
search paths 2-2 
start_up 6-/ 
version number 5-3 


forum command 6-4, 8-2, C-2 
control arguments 6-4 


Forum installation 
instructions A-1 


forum_ subroutine 8-2 
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forum Saccept_notifications 
B-2 
forum_Schange_chairman 6-2 


forum_Schange_chairman_idx 
B-3 

forum _Scheck_user B-8 

forum_Schname_forum B-4 

forum _Schname_forum_idx B-5 

forum_Sclose_forum B-9 

B-9 


forum_Sconvert 


forum_Sconvert_attendee_idx 
B-10 

forum_Screate_forum B~-6 
forum_Sdelete_forum B-10 
forum Sdelete_forum_acl B-11 
forum _Senter_trans B-12 
forum_Sexpunge B-13 
forum_Sforum_info_idx B-16 
forum_Sforum_limits B-17 

forum_S$get_forum_path B-18 


forum_Sget_forum_path_idx 
B-19 
forum_Sget_message B-20 


forum_Sget_transaction_map 
B-21 
forum _Sget_uid_file B-22 


forum_Sinfo B-13 


forum_Slist_forum_ac! 8-23 
forum Slist_users B-24 
forum_Slist_users_ idx B-26 


forum_$]list_vl_forum_ac] 
forum_Sopen_forum B-27 
forum _$read_trans B-28 


forum_Srefuse_notifications 
B- 30 


forum_Sreplace_forum_ac] 
forum_Sset_delete_sw B-31 
forum_Sset_event_channe] 


forum_$set_event_channel_idx 


B-33 
forum Sset_forum_ac! B-34 
forum_Sset_message B-35 


forum_Sset_seen_switch B-36 


forum_$set_switch B-36 


forum_Sset_switch_idx B-38 
forum _Sset_vl_forum_acl B-6 
forum _Strans_ref_info B-39 


forum_$trans_time_info B-40 
forum _$vl_expunge B-7 
forum_Svalidate_uid B-41 
forum_accept_notifications 


(fant) command 3-12, 
8-10 
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B-2h 


B-30 


B-32 


forum_add_meeting (fam) forum_make_public (fmp) 


request 98-11 command 9-4, 10-5 
forum_add_ participant (fapt) forum_refuse_notifications 
command 9-3, 10-2 (frnt) command 3-13, 
8-21 
forum_add_project (fapj) 
command 9-h, 10-3 forum_remove_meeting request 
8-22 


forum_admin command A-k 
forum_remove_participant 


forum_admin_ subroutine B-42 (frpt) command 9-5, 10-6 

forum_admin_Schange_chairman forum_remove_project (frpj) 
B-42 command 9-6, 10-7 

forum_admin_Sconvert B-42 forum_unmake_public (fump) 


command 9-4, 10-8 
forum_admin_Sdelete_forum 


B-43 frnt 
see 
forum_admin_Sinit_notifications forum_refuse_noti fications 
ions B-k4 
forum_admin_Sset_forum_acl frpj 
B-4h see forum_remove_project 


forum_admin_Sset_global_switch  frpt- 
B-&5 see forum_remove_participant 


forum_admin_Sset_switch B-46 fump 
see forum_unmake_public 
forum_create (fcr) command 


9-1, 10-4 
G 
forum_delete (fdl) command 
8-12, 9-11 
. gates A-2 
forum_dir (fd) command 2-2, 
8-13 glossary C-1 
forum_dir (fd) request 7-24 goto (go, g) request 2-5, 
F—!. 
i7e4 


forum_list_meetings (f1sm) 
command 8-14 greeting message 
chairman_message 3-6 
forum_list_users (f1su) 
command 8-18 
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H keywords (cont) 


new 3-4 
next, n 3-h 
neip 2-2, 5-i previous, p 3-4 
? request 5-1 unprocessed, u 3-4 
help request 5-3 
list_help (Ih) request 5-2 
list_requests (ir) request L 
5-2 
help request 5-3, 7-25 lastref (Iref) keyword 3-4 
list (Ils) request 3-1, 7-28 
i 
list_help (lh) request 5-2, 
7-31 
if request 6-3, 7-27 see aiso help 
installation instructions list_meetings (lIsm) request 
AIM A-3 2=1,.J=3:1 
central forum directory A-1 
gate access A-2 list_requests (Ir) request 
notifications database A-2 5-2, 7-34 


see also help 
interrupting lengthy output 
3-13 list_users (lsu) request 2-5, 


6-1, 7-35 


K locating meetings 
search paths 2-2 


keywords 3-2, C-2 
all, a 3-4 M 
as active requests 3-6 
as requests 3-6 


as transaction specifiers mail request 7-38 
3-4 
chain-tracing 3-4 maintaining a meeting 9-2 
allref, aref 3-4 adding a participant 9-3 
firstref, fref 3-4 adding a project 9-4 
lastref, Iref 3-4 deleting transactions 9-7 
nextref, nref 3-5 making a meeting private 
priorref, pref 3-5 9-4 
restref, rref 3-5 making a meeting public 9-4 
chairman_message 3-6 printing eligibility 
current, c 3-4 messages 9-9 
first, f 3-4 removing a participant 9-5 
highest, last_seen 3-4 removing a project 9-6 
last, | 3-4 
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maintaining a meeting (cont) 
retrieving participants and 


transactions 9-8 
setting a message 9-9 


make_public request 7-39 


meetings 1-2, C-2 
attending 2-4 
chairman 2-5 
current C-1 
eligibility message 
eligible participants 
flags 2-2 
listing 2-1 
locating 2-2 
moving A-1 
participants 
private 2-3 
speaking 4-1 

reply (r) request 
talk (t) request 


2-5 


k-1 


Multics command processor 
escape 


nextref (nref) keyword 3-5 


next_meeting (nm) request 
7-40 
notifications 
cancelling 3-13 
receiving 3-12 


notifications database 
creating A-1, A-2 
notify switch 3-12 


numbers 


as transaction specifiers 


3-3 


2-5 


4-2 


5-2, 6-2, 7-3 


° 


on-line help 5-1 


output 
interrupting 3-13 


participant 
expunging 9-5 


participants C-2 
eiigibie 2-6 
listing 2-5 
private meetings 
removing 9-5 
retrieving 9-8 


2-6 


personalizing your Forum 
environment 
abbreviations 
exec_coms 6-6 
forum control arguments 
forum start_up 6-7 


6-6 


Person_ids 


6-4 


as transaction specifiers 


3-7 
print (p) request 4-8 


print (pr, p) request 3- 
7-41 


printing transactions 4- 
priorref (pref) keyword 


private meetings 2-3, 2- 


2; 


8 
3-5 
6 


forum_unmake_public command 


9-4 


proceedings C-2 
listing 3-1 
printing 3-2 
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proceedings (cont) reply (rp) request 4-2, 7-h6 
saving 3-2 
request line C-3 
prompt abbreviations 6-6 
setting 6-5 
request loop 2-1, C-3 
public meetings 
central forum directory 2-2 requests C-3 


eligibility message 2-5 ~ (current) 7-3 
forum_make_public command -.command_line 7-3 
9- ? 5-1 


abbrev 6-6, 7-4 
add_meeting 7-5 

Q add_participant 7-7 
add_project 7-7 
announcement_info 7-9 


qedx announce_meeting 7-8 
request /-43 answer 7-10 
apply 4-6, 7-12 
qedx (qx) request 4-3 chairman 7-14 
simple editor requests 4-4 check_meetings 7-15 
current_meeting 7-16 
qedx regular expression C-2 delete 4-9, 7-16 
delete_participant 7-18 
gedx regular expressions 3-8 do 7-18 
: enter 7-20 
quit (q) request 2-7, 7-44 execute 7-22 


exec_com 6-6, 7-21 
expunge /-22 

R fill 4-8, 7-23 
forum_add_meeting 8-11 
forum_dir 7-24 


ranges of transactions 3-3 - forum_remove meeting 8-22 
goto 7-2kh 
regular expression C-2 help 5-3, 7-25 
if 6-3, 7-27 
regular expressions 3-8 list 7-28 
matching subject 3-8 list_help 5-2, 7-31 
matching text 3-8 list_meetings 7-31 
special characters 3-9 list_requests 5-2, 7-34 
list_users 7-35 
remove_meeting (rm) request mail 7-38 
7-44 make_public 7-39 
next_meeting 7-40 
remove_participant (rpt) print 4-8, 7-41 
request 7-45 qedx 4-3, 7-43 
quit 7-hk 
remove_project (rpj) request remove_meeting 7-44 
7-h6 remove_participant 7-45 


i-8 CY74-02 


requests (cont) 
remove_project 7-46 
reply 4-2, 77h6 
reset 7-48 
retrieve 4-9, 7-49 
retrieve_participant 
send 7-20 
set_message 7-51, 9-9 
subject 4-9, 7-52 
subsystem_name 7-53 
subsystem_version 7-54 
switch_off 7-54 
switch_on 7-55 
talk 4-1, 7-56 
ted 4-3, 7-58 
unmake_public 
write 7-60 


7-50 


7-59 


7-48 


reset (r) request 
restref (rref) keyword 3-5 


retrieve (rt) request 4-9, 
7-49, 9-8 


retrieve participa 
request 7-50 


nt (rtpt) 
3 


9-8 


search list C-3 


search patns 2-2, 2-3, C-3 
in your start_up.ec 2-4 
printing 2-3 
setting 2-3 


send (enter, en) request 7-20 


set_message request 7-51, 9-9 
sorting by chain 3-8 
speaking 


reply (rp) request 4-2 
talk (t) request 4-1 


start_up.ec 6-8 
accepting notifications 
3-13 
search paths 2-4 


start_up.fmec 6-7 
subject (sj) request 4-9, 


7-52 


subroutine descriptions 
forum_ B-2 
forum_admin_ B-42 

subsystem_name request 7-53 


subsystem_version request 


7-54 


switches 2-2 

notify 3-12 
switch_off (swf) request 3-13, 
7-54, 9-10 


talk (t) request 4-1, 7-56 


ted request 4-3, 7-58 
text editors 

emacs 4-6 

gedx 4-3 

ted 4-3 


transaction 1-2 
chain 1-3 
current C-1 
initial 1-2 

transaction chain 1-3, 4-3, 

C-3 

keywords 3-4 
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transaction chain (cont) U 
sorting by 3-8 


transaction numbers 3-3 unmake_public (ump) request 
7-59 
transaction specifiers 3-1, 
3-3, C-3 unprocessed transaction 3-h, 
by date and time 3-7 4-5, C-3 
by subject 3-8 
by text 3-8 users ’ commands 
chairman_message (cmsg) 3-6 forum 8-2 
control arguments 3-6 forum_accept_notifications 
examples 3-9 (fant) 8-10 
keywords 3-4 forum_dir (fd) 8-13 
chain-tracing 3-4 forum_list_meetings (f1sm) 
numbers 3-3 8-1h 
Person_ids 3-7 forum_list_users (f1su) 
ranges of numbers 3-3 8-18 
regular expressions 3-8 forum_refuse_notifications 
simple operators 3-3 (frnt} 8-21 


sorting by chain 3-8 


transactions C-3 Vv 
current 3-3 
deleting 4-9, 9-7 


editing version number 5-3 

emacs 4-6 ; 

qedx 4-3 

ted 4-3 W 
expunging 9-8 
filling 4-8 
listing 3-1 write (w) request 3-2, 7-60 
new 3-11 delimiters 3-3 

receiving notification formatted output 3-3 

3-12 naming the segment 3-2 


pre-written 4-6 

printing 3-2, 4-8 

ranges of 3-3 

retrieving 4-9, 9-8 

saving 3-2 
delimiters 3-3 
formatted output 3-3 
naming the segment 3-2 

unprocessed 4-5 
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